Класс PlainView

Все реализованные интерфейсы:
SwingConstants, TabExpander
Прямые известные подклассы:
FieldView
public class PlainView
extends View
implements TabExpander

Реализует интерфейс View для простого многострочного представления текста, имеющего текст в одном шрифте и цвете. Представление отображает каждый дочерний элемент как строку текста.

См. также:
View

Поля

Модификатор и тип Поле Описание
protected FontMetrics metrics

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

Поля, объявленные в классе javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе javax.swing.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)

Устарело.

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)

Устарело.

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)

Устарело.

protected 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)

Предоставляет отображение из пространства координат представления в логическое пространство координат модели.

Методы, объявленные в классе javax.swing.text.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

Методы, объявленные в классе java.lang.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)
Устаревшее.

Отображает строку текста, подавляя пробелы в конце и расширяя все табуляции. Это реализовано для вызова методов drawUnselectedText и drawSelectedText, чтобы можно было настроить способ отображения выделенного и невыделенного текста.

Параметры:
lineIndex - строка для отображения >= 0
g - контекст Graphics
x - начальная позиция X >= 0
y - начальная позиция Y >= 0
См. также:
drawUnselectedText(java.awt.Graphics, int, int, int, int), drawSelectedText(java.awt.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(java.awt.Graphics, int, int, int, int), drawSelectedText(java.awt.Graphics, int, int, int, int)

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 - для недопустимой оси
См. также:
View.getPreferredSpan(int)

paint

public void paint(Graphics g,
                  Shape a)

Отображает с использованием заданной поверхности отрисовки и области на этой поверхности. Представлению может потребоваться выполнить макет и создать дочерние представления, чтобы позволить ему отобразиться в заданном расположении.

Определено в:
paint в классе View
Параметры:
g - поверхность отрисовки для использования
a - выделенная область для отображения
См. также:
View.paint(java.awt.Graphics, java.awt.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, java.awt.Shape, javax.swing.text.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, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

public void insertUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)

Уведомляет о том, что в документ была вставлена информация в местоположение, за которое отвечает это представление.

Переопределяет:
insertUpdate в классе View
Параметры:
changes - информация о изменении из связанного документа
a - текущее расположение представления
f - фабрика для использования при перестроении, если у представления есть дочерние элементы
См. также:
View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

removeUpdate

public void removeUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)

Уведомляет о том, что из документа была удалена информация в местоположение, за которое отвечает это представление.

Переопределяет:
removeUpdate в классе View
Параметры:
changes - информация о изменении из связанного документа
a - текущее расположение представления
f - фабрика для использования при перестроении, если у представления есть дочерние элементы
См. также:
View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

changedUpdate

public void changedUpdate(DocumentEvent changes,
                          Shape a,
                          ViewFactory f)

Уведомляет от документа о том, что атрибуты были изменены в местоположение, за которое отвечает это представление.

Переопределяет:
changedUpdate в классе View
Параметры:
changes - информация о изменениях из связанного документа
a - текущее распределение представления
f - фабрика для повторного построения, если у представления есть дочерние элементы
См. также:
View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.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)

Перерисовывает заданный диапазон строк.

Параметры:
host - компонент, размещающий представление (используется для вызова repaint)
a - область, выделенная для отображения представления
line0 - номер начальной строки для перерисовки. Он должен быть действительным номером строки в модели.
line1 - номер конечной строки для перерисовки. Он должен быть действительным номером строки в модели.
С:
1.4

lineToRect

protected Rectangle lineToRect(Shape a,
                               int line)

Определяет прямоугольник, представляющий данную строку.

Параметры:
a - область, выделенная для отображения представления
line - номер строки, для которой нужно найти область. Он должен быть действительным номером строки в модели.
Возвращает:
прямоугольник, представляющий данную строку
С:
1.4

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/text/PlainView.html

Spec-Zone .ru
спецификации, руководства, описания, API