Spec-Zone.ru › OpenJDK 25

Класс PlainView

java.lang.Object
javax.swing.text.View
javax.swing.text.PlainView
Все реализуемые интерфейсы:
SwingConstants, TabExpander
Прямые известные подклассы:
FieldView
public class PlainView extends View implements TabExpander
Реализует интерфейс View для простого многострочного текстового представления, в котором текст имеет один шрифт и цвет. Представление отображает каждый дочерний элемент как строку текста.
См. также:
  • View

Краткое описание полей

Модификатор и тип Поле Описание
protected FontMetrics metrics
Метрики шрифта для текущего шрифта.

Поля, объявленные в классе View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Краткое описание конструкторов

Конструктор Описание
PlainView(Element elem)
Создает новое PlainView, обернутое вокруг элемента.

Краткое описание методов

Модификатор и тип Метод Описание
void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет представление об изменении атрибутов документа в области, за которую отвечает это представление.
protected void damageLineRange(int line0, int line1, Shape a, Component host)
Перерисовывает указанный диапазон строк.
protected void drawLine(int lineIndex, Graphics2D g, float x, float y)
Отображает строку текста, удаляя пробелы в конце и раскрывая символы табуляции.
protected void drawLine(int lineIndex, Graphics g, int x, int y)
Устарел.
заменен на drawLine(int, Graphics2D, float, float)
protected float drawSelectedText(Graphics2D g, float x, float y, int p0, int p1)
Отображает указанный диапазон модели как выделенный текст.
protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1)
Устарел.
заменен на drawSelectedText(Graphics2D, float, float, int, int)
protected float drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1)
Отображает указанный диапазон модели как обычный невыделенный текст.
protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1)
Устарел.
заменен на drawUnselectedText(Graphics2D, float, float, int, int)
protected final Segment getLineBuffer()
Предоставляет доступ к буферу, который можно использовать для извлечения текста из связанного документа.
float getPreferredSpan(int axis)
Определяет предпочтительный размер этого представления вдоль оси.
protected int getTabSize()
Возвращает размер табуляции, заданный для документа; по умолчанию равен 8.
void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
protected Rectangle lineToRect(Shape a, int line)
Определяет прямоугольник, представляющий указанную строку.
Shape modelToView(int pos, Shape a, Position.Bias b)
Обеспечивает отображение координатного пространства модели документа в координатное пространство соответствующего ей представления.
float nextTabStop(float x, int tabOffset)
Возвращает позицию следующей позиции табуляции после заданной опорной позиции.
void paint(Graphics g, Shape a)
Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности.
void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет об удалении данных из документа в области, за которую отвечает это представление.
void setSize(float width, float height)
Задает размер представления.
protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f)
Перерисовывает область изменений, охватываемую указанным событием документа.
protected void updateMetrics()
Проверяет, актуальны ли метрики шрифта и самая длинная строка.
int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
Обеспечивает отображение координатного пространства представления в логическое координатное пространство модели.

Методы, объявленные в классе View

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

metrics

protected FontMetrics metrics
Метрики шрифта для текущего шрифта.

Подробное описание конструкторов

PlainView

public PlainView(Element elem)
Создает новое PlainView, обернутое вокруг элемента.
Параметры:
elem — элемент

Подробное описание методов

getTabSize

protected int getTabSize()
Возвращает размер табуляции, заданный для документа; по умолчанию равен 8.
Возвращает:
размер табуляции

drawLine

@Deprecated(since="9") protected void drawLine(int lineIndex, Graphics g, int x, int y)
Устарел.
заменен на drawLine(int, Graphics2D, float, float)
Отображает строку текста, удаляя пробелы в конце и раскрывая символы табуляции. Реализация вызывает методы drawUnselectedText и drawSelectedText, чтобы можно было настроить способ отображения выделенного и невыделенного текста.
Параметры:
lineIndex — строка для отрисовки >= 0
g — контекст Graphics
x — начальная позиция X >= 0
y — начальная позиция Y >= 0
См. также:
  • drawUnselectedText(Graphics, int, int, int, int)
  • drawSelectedText(Graphics, int, int, int, int)

drawLine

protected void drawLine(int lineIndex, Graphics2D g, float x, float y)
Отображает строку текста, удаляя пробелы в конце и раскрывая символы табуляции. Реализация вызывает методы drawUnselectedText и drawSelectedText, чтобы можно было настроить способ отображения выделенного и невыделенного текста.
Параметры:
lineIndex — строка для отрисовки >= 0
g — контекст Graphics
x — начальная позиция X >= 0
y — начальная позиция Y >= 0
Начиная с версии:
9
См. также:
  • drawUnselectedText(Graphics, int, int, int, int)
  • drawSelectedText(Graphics, int, int, int, int)

drawUnselectedText

@Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
Устарел.
заменен на drawUnselectedText(Graphics2D, float, float, int, int)
Отображает указанный диапазон модели как обычный невыделенный текст. Для отображения текста используется цвет переднего плана или цвет для отключенного состояния.
Параметры:
g — графический контекст
x — начальная координата X >= 0
y — начальная координата Y >= 0
p0 — начальная позиция в модели >= 0
p1 — конечная позиция в модели >= 0
Возвращает:
координату X в конце диапазона >= 0
Выбрасывает:
BadLocationException — если диапазон недопустим

drawUnselectedText

protected float drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException
Отображает указанный диапазон модели как обычный невыделенный текст. Для отображения текста используется цвет переднего плана или цвет для отключенного состояния.
Параметры:
g — графический контекст
x — начальная координата X >= 0
y — начальная координата Y >= 0
p0 — начальная позиция в модели >= 0
p1 — конечная позиция в модели >= 0
Возвращает:
координату X в конце диапазона >= 0
Выбрасывает:
BadLocationException — если диапазон недопустим
Начиная с версии:
9

drawSelectedText

@Deprecated(since="9") protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
Устарел.
заменен на drawSelectedText(Graphics2D, float, float, int, int)
Отображает указанный диапазон модели как выделенный текст. Реализация отображает текст цветом, заданным в содержащем компоненте. Предполагается, что подсветка отобразит фон выделения.
Параметры:
g — графический контекст
x — начальная координата X >= 0
y — начальная координата Y >= 0
p0 — начальная позиция в модели >= 0
p1 — конечная позиция в модели >= 0
Возвращает:
координату конца диапазона
Выбрасывает:
BadLocationException — если диапазон недопустим

drawSelectedText

protected float drawSelectedText(Graphics2D g, float x, float y, int p0, int p1) throws BadLocationException
Отображает указанный диапазон модели как выделенный текст. Реализация отображает текст цветом, заданным в содержащем компоненте. Предполагается, что подсветка отобразит фон выделения.
Параметры:
g — графический контекст
x — начальная координата X >= 0
y — начальная координата Y >= 0
p0 — начальная позиция в модели >= 0
p1 — конечная позиция в модели >= 0
Возвращает:
координату конца диапазона
Выбрасывает:
BadLocationException — если диапазон недопустим
Начиная с версии:
9

getLineBuffer

protected final Segment getLineBuffer()
Предоставляет доступ к буферу, который можно использовать для извлечения текста из связанного документа.
Возвращает:
буфер

updateMetrics

protected void updateMetrics()
Проверяет, актуальны ли метрики шрифта и самая длинная строка.
Начиная с версии:
1.4

getPreferredSpan

public float getPreferredSpan(int axis)
Определяет предпочтительный размер этого представления вдоль оси.
Определено в:
getPreferredSpan в классе View
Параметры:
axis — может быть View.X_AXIS или View.Y_AXIS
Возвращает:
размер, в пределах которого представление предпочтительно отображать >= 0. Обычно представлению задается размер, равный возвращенному значению, однако это не гарантируется. Родительский элемент может изменить размер представления или разделить его.
Выбрасывает:
IllegalArgumentException — если указана недопустимая ось

paint

public void paint(Graphics g, Shape a)
Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности. Представлению может потребоваться выполнить компоновку и создать дочерние представления, чтобы отобразить себя в заданной области.
Определено в:
paint в классе View
Параметры:
g — используемая поверхность отрисовки
a — выделенная область для отрисовки
См. также:
  • View.paint(Graphics, Shape)

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException
Обеспечивает отображение координатного пространства модели документа в координатное пространство соответствующего ей представления.
Определено в:
modelToView в классе View
Параметры:
pos — позиция для преобразования >= 0
a — выделенная область для отрисовки
b — смещение в сторону предыдущего или следующего символа, представленного смещением, если позиция находится на границе двух представлений; b будет иметь одно из следующих значений:
  • Position.Bias.Forward
  • Position.Bias.Backward
Возвращает:
ограничивающий прямоугольник указанной позиции
Выбрасывает:
BadLocationException — если указанная позиция не соответствует допустимому месту в связанном документе
См. также:
  • View.modelToView(int, Shape, Position.Bias)

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
Обеспечивает отображение координатного пространства представления в логическое координатное пространство модели.
Определено в:
viewToModel в классе View
Параметры:
x — координата X >= 0
y — координата Y >= 0
a — выделенная область для отрисовки
bias — возвращаемое смещение
Возвращает:
позицию в модели, которая лучше всего соответствует указанной точке в представлении >= 0
См. также:
  • View.viewToModel(float, float, Shape, Position.Bias[])

insertUpdate

public void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
Переопределяет:
insertUpdate в классе View
Параметры:
changes — сведения об изменении из связанного документа
a — текущее выделение области для представления
f — фабрика для перестроения представления, если у него есть дочерние элементы
См. также:
  • View.insertUpdate(DocumentEvent, Shape, ViewFactory)

removeUpdate

public void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет об удалении данных из документа в области, за которую отвечает это представление.
Переопределяет:
removeUpdate в классе View
Параметры:
changes — сведения об изменении из связанного документа
a — текущее выделение области для представления
f — фабрика для перестроения представления, если у него есть дочерние элементы
См. также:
  • View.removeUpdate(DocumentEvent, Shape, ViewFactory)

changedUpdate

public void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет представление об изменении атрибутов документа в области, за которую отвечает это представление.
Переопределяет:
changedUpdate в классе View
Параметры:
changes — сведения об изменении из связанного документа
a — текущее выделение области для представления
f — фабрика для перестроения представления, если у него есть дочерние элементы
См. также:
  • View.changedUpdate(DocumentEvent, Shape, ViewFactory)

setSize

public void setSize(float width, float height)
Задает размер представления. Если на представлении лежат какие-либо обязанности по компоновке, это должно привести к компоновке вдоль указанной оси.
Переопределяет:
setSize в классе View
Параметры:
width — ширина >= 0
height — высота >= 0

nextTabStop

public float nextTabStop(float x, int tabOffset)
Возвращает позицию следующей позиции табуляции после заданной опорной позиции. Эта реализация не поддерживает такие возможности, как выравнивание по центру, поэтому игнорирует аргумент tabOffset.
Определено в:
nextTabStop в интерфейсе TabExpander
Параметры:
x — текущая позиция >= 0
tabOffset — позиция в текстовом потоке, в которой встретился символ табуляции >= 0.
Возвращает:
позицию табуляции, измеренную в пунктах >= 0

updateDamage

protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f)
Перерисовывает область изменений, охватываемую указанным событием документа. Помечает как поврежденную строку, в которой начинается диапазон, чтобы учесть случай, когда вставка или удаление затрагивает только одну строку. Если строки добавлены или удалены, поврежденным считается все представление. Проверяется, изменилась ли самая длинная строка.
Параметры:
changes — сведения об изменении из связанного документа
a — текущее выделение области для представления
f — фабрика для перестроения представления, если у него есть дочерние элементы
Начиная с версии:
1.4

damageLineRange

protected void damageLineRange(int line0, int line1, Shape a, Component host)
Перерисовывает указанный диапазон строк.
Параметры:
line0 — номер первой строки для перерисовки. Это должен быть допустимый номер строки в модели.
line1 — номер последней строки для перерисовки. Это должен быть допустимый номер строки в модели.
a — область, выделенная для отрисовки представления
host — компонент, содержащий представление (используется для вызова repaint)
Начиная с версии:
1.4

lineToRect

protected Rectangle lineToRect(Shape a, int line)
Определяет прямоугольник, представляющий указанную строку.
Параметры:
a — область, выделенная для отрисовки представления
line — номер строки, область которой нужно найти. Это должен быть допустимый номер строки в модели.
Возвращает:
прямоугольник, представляющий указанную строку
Начиная с версии:
1.4

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, которая содержит более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/PlainView.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API