Класс PlainView
java.lang.Object
javax.swing.text.View
javax.swing.text.PlainView
- Все реализуемые интерфейсы:
SwingConstants, TabExpander
- Прямые известные подклассы:
FieldView
public class PlainView extends View implements TabExpander
Реализует интерфейс 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 |
Создает новое PlainView, обернутое вокруг элемента. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
changedUpdate |
Уведомляет представление об изменении атрибутов документа в области, за которую отвечает это представление. |
protected void |
damageLineRange |
Перерисовывает указанный диапазон строк. |
protected void |
drawLine |
Отображает строку текста, удаляя пробелы в конце и раскрывая символы табуляции. |
protected void |
drawLine |
Устарел. |
protected float |
drawSelectedText |
Отображает указанный диапазон модели как выделенный текст. |
protected int |
drawSelectedText |
Устарел. |
protected float |
drawUnselectedText |
Отображает указанный диапазон модели как обычный невыделенный текст. |
protected int |
drawUnselectedText |
Устарел. |
protected final Segment |
getLineBuffer() |
Предоставляет доступ к буферу, который можно использовать для извлечения текста из связанного документа. |
float |
getPreferredSpan |
Определяет предпочтительный размер этого представления вдоль оси. |
protected int |
getTabSize() |
Возвращает размер табуляции, заданный для документа; по умолчанию равен 8. |
void |
insertUpdate |
Уведомляет о вставке данных в документ в области, за которую отвечает это представление. |
protected Rectangle |
lineToRect |
Определяет прямоугольник, представляющий указанную строку. |
Shape |
modelToView |
Обеспечивает отображение координатного пространства модели документа в координатное пространство соответствующего ей представления. |
float |
nextTabStop |
Возвращает позицию следующей позиции табуляции после заданной опорной позиции. |
void |
paint |
Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности. |
void |
removeUpdate |
Уведомляет об удалении данных из документа в области, за которую отвечает это представление. |
void |
setSize |
Задает размер представления. |
protected void |
updateDamage |
Перерисовывает область изменений, охватываемую указанным событием документа. |
protected void |
updateMetrics() |
Проверяет, актуальны ли метрики шрифта и самая длинная строка. |
int |
viewToModel |
Обеспечивает отображение координатного пространства представления в логическое координатное пространство модели. |
Методы, объявленные в классе 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
Подробное описание полей
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 - См. также:
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
@Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException
Устарел.
Отображает указанный диапазон модели как обычный невыделенный текст. Для отображения текста используется цвет переднего плана или цвет для отключенного состояния.
- Параметры:
-
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
Устарел.
Отображает указанный диапазон модели как выделенный текст. Реализация отображает текст цветом, заданным в содержащем компоненте. Предполагается, что подсветка отобразит фон выделения.
- Параметры:
-
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)
Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности. Представлению может потребоваться выполнить компоновку и создать дочерние представления, чтобы отобразить себя в заданной области.
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— если указанная позиция не соответствует допустимому месту в связанном документе - См. также:
viewToModel
public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
Обеспечивает отображение координатного пространства представления в логическое координатное пространство модели.
- Определено в:
-
viewToModelв классеView - Параметры:
-
x— координата X >= 0 -
y— координата Y >= 0 -
a— выделенная область для отрисовки -
bias— возвращаемое смещение - Возвращает:
- позицию в модели, которая лучше всего соответствует указанной точке в представлении >= 0
- См. также:
insertUpdate
public void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
- Переопределяет:
-
insertUpdateв классеView - Параметры:
-
changes— сведения об изменении из связанного документа -
a— текущее выделение области для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
removeUpdate
public void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет об удалении данных из документа в области, за которую отвечает это представление.
- Переопределяет:
-
removeUpdateв классеView - Параметры:
-
changes— сведения об изменении из связанного документа -
a— текущее выделение области для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
changedUpdate
public void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
Уведомляет представление об изменении атрибутов документа в области, за которую отвечает это представление.
- Переопределяет:
-
changedUpdateв классеView - Параметры:
-
changes— сведения об изменении из связанного документа -
a— текущее выделение области для представления -
f— фабрика для перестроения представления, если у него есть дочерние элементы - См. также:
setSize
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
© 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
drawLine(int, Graphics2D, float, float)