Spec-Zone.ru › OpenJDK 21

Класс 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

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

Поля, объявленные в классе 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
См. также:
  • drawUnselectedText(java.awt.Graphics, int, int, int, int)
  • drawSelectedText(java.awt.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(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
Устарело.
заменено на 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(javax.swing.text.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(java.awt.Graphics, java.awt.Shape)

setSize

public void setSize(float width, float height)
Устанавливает размер представления. Это должно привести к размещению представления вдоль указанной оси, если у него есть какие-либо задачи размещения.
Переопределяет:
setSize в классе BoxView
Параметры:
width - ширина >= 0
height - высота >= 0

getPreferredSpan

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

getMinimumSpan

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

getMaximumSpan

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

insertUpdate

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

removeUpdate

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

changedUpdate

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/text/WrappedPlainView.html

Spec-Zone.ru

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