Класс WrappedPlainView

javax.swing.text.WrappedPlainView

Все реализованные интерфейсы:: SwingConstants, TabExpander

public class WrappedPlainView extends BoxView implements TabExpander

Представление простого текста (текста с одним шрифтом и цветом), выполняющее перенос строк. Это представление ожидает, что его связанный элемент имеет дочерние элементы, которые представляют строки, которые должны быть переносимы. Оно реализовано как вертикальная область, содержащая логические представления строк. Логические представления строк — это вложенные классы, которые отображают логическую строку как несколько физических строк, если логическая строка слишком широка, чтобы поместиться в выделение. Представления строк используют состояние внешнего класса для уменьшения потребности в памяти.

Представления строк выполняют все своё отображение через метод drawLine, который в свою очередь выполняет всё отображение через методы drawSelectedText и drawUnselectedText. Это позволяет подклассам легко специализировать отображение без необходимости учитывать аспекты макета.

См. также:

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

Поля, объявленные в классе 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

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

Конструктор	Описание
`WrappedPlainView(Element elem)`	Создаёт новый WrappedPlainView.
`WrappedPlainView(Element elem, boolean wordWrap)`	Создаёт новый WrappedPlainView.

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

Модификатор и тип	Метод	Описание
`protected int`	`calculateBreakPosition(int p0, int p1)`	Вызывается вложенными представлениями обернутой строки для определения позиции разрыва.
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Предоставляет уведомление от документа о том, что атрибуты были изменены в позиции, за которую отвечает это представление.
`protected void`	`drawLine(int p0, int p1, Graphics2D g, float x, float y)`	Отображает строку текста, подавляя пробелы в конце и расширяя табуляции.
`protected void`	`drawLine(int p0, int p1, Graphics g, int x, int y)`	Устарело. заменено на `drawLine(int, 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`	`getMaximumSpan(int axis)`	Определяет максимальную длину для этого представления по оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальную длину для этого представления по оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительную длину для этого представления по оси.
`protected int`	`getTabSize()`	Возвращает размер табуляции, установленный для документа, по умолчанию 8.
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Предоставляет уведомление о вставке чего-либо в документ в позиции, за которую отвечает это представление.
`protected void`	`loadChildren(ViewFactory f)`	Загружает все дочерние элементы для инициализации представления.
`float`	`nextTabStop(float x, int tabOffset)`	Возвращает позицию следующей табуляции после заданной опорной позиции.
`void`	`paint(Graphics g, Shape a)`	Отображает, используя заданную поверхность отображения и область на этой поверхности.
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Предоставляет уведомление об удалении чего-либо из документа в позиции, за которую отвечает это представление.
`void`	`setSize(float width, float height)`	Устанавливает размер представления.

Методы, объявленные в классе javax.swing.text.BoxView

baselineLayout, baselineRequirements, calculateMajorAxisRequirements, calculateMinorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getOffset, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paintChild, preferenceChanged, replace, setAxis, viewToModel

Методы, объявленные в классе javax.swing.text.CompositeView

getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, modelToView, setInsets, setParagraphInsets, setParent

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

append, breakView, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, isVisible, modelToView, remove, removeAll, updateChildren, updateLayout, viewToModel

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

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

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

WrappedPlainView

public WrappedPlainView(Element elem)

Создаёт новый WrappedPlainView. Строки будут разрываться на границах символов.

Параметры:: elem - элемент, лежащий в основе представления

WrappedPlainView

public WrappedPlainView(Element elem, boolean wordWrap)

Создаёт новый WrappedPlainView. Строки могут быть разрываются на границах символов или слов, в зависимости от параметра wordWrap.

Параметры:: elem - элемент, лежащий в основе представления; wordWrap - должны ли строки разрываться на границах слов?

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

getTabSize

protected int getTabSize()

Возвращает размер табуляции, установленный для документа, по умолчанию 8.

Возвращает:: размер табуляции

drawLine

@Deprecated(since="9") protected void drawLine(int p0, int p1, Graphics g, int x, int y)

Устарело.

заменено на drawLine(int, int, Graphics2D, float, float)

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

Параметры:

p0 - начальное местоположение в документе >= 0

p1 - конечное местоположение в документе >= p1

g - контекст графики

x - начальная координата X >= 0

y - начальная координата Y >= 0

См. также:

drawLine

protected void drawLine(int p0, int p1, Graphics2D g, float x, float y)

Параметры:

p0 - начальное местоположение в документе >= 0

p1 - конечное местоположение в документе >= p1

g - контекст графики

x - начальная координата X >= 0

y - начальная координата Y >= 0

С тех пор:

См. также:

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 - конечная позиция в модели >= p0
Возвращает:: координату 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 - конечная позиция в модели >= p0
Возвращает:: координату 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 - конечная позиция в модели >= p0
Возвращает:: местоположение конца диапазона.
Исключения:: 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 - конечная позиция в модели >= p0
Возвращает:: местоположение конца диапазона.
Исключения:: BadLocationException - если диапазон недействителен
С тех пор:: 9

getLineBuffer

protected final Segment getLineBuffer()

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

Возвращает:: буфер

calculateBreakPosition

protected int calculateBreakPosition(int p0, int p1)

Вызывается вложенными представлениями строк с перерывами для определения места перерыва. Можно переопределить для изменения поведения перерыва. Перерыв будет осуществлён на границах слов или символов в зависимости от аргумента разрыва, заданного при создании.

Параметры:: p0 - начальное местоположение в документе; p1 - конечное местоположение в документе
Возвращает:: позицию перерыва

loadChildren

protected void loadChildren(ViewFactory f)

Загружает всех потомков для инициализации представления. Вызывается методом setParent. Подклассы могут переопределить этот метод, чтобы инициализировать свои дочерние представления другим способом. По умолчанию создаётся дочернее представление для каждого дочернего элемента.

Переопределяет:

loadChildren в классе CompositeView

Параметры:

f - фабрика представлений

См. также:

nextTabStop

public float nextTabStop(float x, int tabOffset)

Возвращает следующую позицию табуляции после заданной опорной позиции. Эта реализация не поддерживает такие вещи, как центрирование, поэтому игнорирует аргумент tabOffset.

Определено в:: nextTabStop в интерфейсе TabExpander
Параметры:: x - текущая позиция >= 0; tabOffset - позиция в потоке текста, где произошла табуляция >= 0.
Возвращает:: позицию табуляции, измеряемую в пунктах >= 0

paint

public void paint(Graphics g, Shape a)

Отображает с помощью заданной поверхности отрисовки и области на этой поверхности. Это реализовано для хранения позиций, цветов и метрик шрифтов выделения для использования вложенными строками.

Переопределяет:

paint в классе BoxView

Параметры:

g - поверхность отрисовки для использования

a - выделенная область для отрисовки

См. также:

Установить размер

public void setSize(float width, float height)

Устанавливает размер представления. Это должно вызвать обновление макета представления вдоль заданной оси, если оно имеет какие-либо обязанности по макетированию.

Переопределяет:: setSize в классе BoxView
Параметры:: width - ширина >= 0; height - высота >= 0

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет предпочтительный размер для этого представления вдоль оси. Это реализовано для обеспечения поведения суперкласса после предварительного кэширования текущей метрики шрифта (для вложенных строк, которые используют метрики для определения высоты потенциально переносимых строк).

Переопределяет:

getPreferredSpan в классе BoxView

Параметры:

axis - может быть либо View.X_AXIS, либо View.Y_AXIS

Возвращает:

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

См. также:

getMinimumSpan

public float getMinimumSpan(int axis)

Определяет минимальный размер для этого представления вдоль оси. Это реализовано для обеспечения поведения суперкласса после предварительного кэширования текущей метрики шрифта (для вложенных строк, которые используют метрики для определения высоты потенциально переносимых строк).

Переопределяет:

getMinimumSpan в классе BoxView

Параметры:

axis - может быть либо View.X_AXIS, либо View.Y_AXIS

Возвращает:

См. также:

getMaximumSpan

public float getMaximumSpan(int axis)

Определяет максимальный размер для этого представления вдоль оси. Это реализовано для обеспечения поведения суперкласса после предварительного кэширования текущей метрики шрифта (для вложенных строк, которые используют метрики для определения высоты потенциально переносимых строк).

Переопределяет:

getMaximumSpan в классе BoxView

Параметры:

axis - может быть либо View.X_AXIS, либо View.Y_AXIS

Возвращает:

См. также:

insertUpdate

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

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

Переопределяет:

insertUpdate в классе View

Параметры:

e - информация о изменении из связанного документа

a - текущее размещение представления

f - фабрика, используемая для перестроения, если представление имеет дочерние элементы

См. также:

removeUpdate

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

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

Переопределяет:

removeUpdate в классе View

Параметры:

e - информация о изменении из связанного документа

a - текущее размещение представления

f - фабрика, используемая для перестроения, если представление имеет дочерние элементы

См. также:

changedUpdate

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

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

Переопределяет:

changedUpdate в классе View

Параметры:

e - информация о изменении из связанного документа

a - текущее размещение представления

f - фабрика, используемая для перестроения, если представление имеет дочерние элементы

См. также:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/WrappedPlainView.html