Spec-Zone.ru › OpenJDK 17

Класс 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, 2021, 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/17/docs/api/java.desktop/javax/swing/text/WrappedPlainView.html

Spec-Zone.ru

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