Spec-Zone.ru › OpenJDK 25

Класс WrappedPlainView

java.lang.Object
javax.swing.text.View
javax.swing.text.CompositeView
javax.swing.text.BoxView
javax.swing.text.WrappedPlainView
Все реализованные интерфейсы:
SwingConstants, TabExpander
public class WrappedPlainView extends BoxView implements TabExpander
Представление обычного текста (текста с одним шрифтом и цветом), выполняющее перенос строк. Это представление предполагает, что связанный с ним элемент имеет дочерние элементы, представляющие строки, которые следует переносить. Оно реализовано как вертикальный контейнер, содержащий представления логических строк. Представления логических строк — это вложенные классы, отображающие логическую строку в виде нескольких физических строк, если логическая строка слишком широка и не помещается в выделенной области. Представления строк используют состояние внешнего класса, чтобы сократить потребление памяти.

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

См. также:
  • View

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

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

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

Конструктор Описание
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)
Задает размер представления.

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

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

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

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

Методы, объявленные в классе 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
См. также:
  • drawUnselectedText(Graphics, int, int, int, int)
  • drawSelectedText(Graphics, int, int, int, int)

drawLine

protected void drawLine(int p0, int p1, Graphics2D g, float x, float y)
Отрисовывает строку текста, удаляя пробелы в конце и раскрывая символы табуляции. Реализация вызывает методы drawUnselectedText и drawSelectedText, чтобы можно было настраивать способ отрисовки выделенного и невыделенного текста.
Параметры:
p0 — начальная позиция в документе, используемая для отрисовки, >= 0
p1 — конечная позиция в документе, используемая для отрисовки, >= p1
g — графический контекст
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 — конечная позиция в модели, >= 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)
Этот метод вызывается вложенными представлениями переносимых строк для определения места переноса. Его можно переопределить, чтобы изменить поведение переноса. Перенос будет выполняться по границам слов или символов в зависимости от аргумента break, переданного при создании.
Параметры:
p0 — начальная позиция в документе
p1 — конечная позиция в документе, используемая для отрисовки
Возвращает:
позицию переноса

loadChildren

protected void loadChildren(ViewFactory f)
Загружает все дочерние элементы для инициализации представления. Этот метод вызывается методом setParent. Подклассы могут переопределить его, чтобы инициализировать дочерние представления иным способом. Реализация по умолчанию создает дочернее представление для каждого дочернего элемента.
Переопределяет:
loadChildren в классе CompositeView
Параметры:
f — фабрика представлений
См. также:
  • CompositeView.setParent(View)

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 — выделенная область для отрисовки
См. также:
  • View.paint(Graphics, Shape)

setSize

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
Возвращает:
размер области, в которой представление желательно отрисовать. Обычно представлению предписывается отрисовка в области указанного размера, однако это не гарантируется. Родительское представление может изменить размер представления или разбить его.
См. также:
  • View.getPreferredSpan(int)

getMinimumSpan

public float getMinimumSpan(int axis)
Определяет минимальный размер этого представления вдоль оси. Реализация обеспечивает поведение суперкласса, предварительно удостоверившись, что метрики текущего шрифта кэшированы (вложенные строки используют эти метрики для определения высоты потенциально переносимых строк).
Переопределяет:
getMinimumSpan в классе BoxView
Параметры:
axis — может принимать значение View.X_AXIS или View.Y_AXIS
Возвращает:
размер области, в которой представление желательно отрисовать. Обычно представлению предписывается отрисовка в области указанного размера, однако это не гарантируется. Родительское представление может изменить размер представления или разбить его.
См. также:
  • View.getMinimumSpan(int)

getMaximumSpan

public float getMaximumSpan(int axis)
Определяет максимальный размер этого представления вдоль оси. Реализация обеспечивает поведение суперкласса, предварительно удостоверившись, что метрики текущего шрифта кэшированы (вложенные строки используют эти метрики для определения высоты потенциально переносимых строк).
Переопределяет:
getMaximumSpan в классе BoxView
Параметры:
axis — может принимать значение View.X_AXIS или View.Y_AXIS
Возвращает:
размер области, в которой представление желательно отрисовать. Обычно представлению предписывается отрисовка в области указанного размера, однако это не гарантируется. Родительское представление может изменить размер представления или разбить его.
См. также:
  • View.getMaximumSpan(int)

insertUpdate

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

removeUpdate

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

changedUpdate

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по 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/WrappedPlainView.html

Spec-Zone.ru

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