Класс ParagraphView

javax.swing.text.ParagraphView

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

Прямые известные подклассы:: ParagraphView

public class ParagraphView extends FlowView implements TabExpander

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

См. также:

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе FlowView

FlowView.FlowStrategy

Модификатор и тип	Класс	Описание
`static class`	`FlowView.FlowStrategy`	Стратегия поддержки физической формы потока.

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

Модификатор и тип	Поле	Описание
`protected int`	`firstLineIndent`	Отступ первой строки от левого внутреннего поля.

Поля, объявленные в классе FlowView

layoutPool, layoutSpan, strategy

Модификатор и тип	Поле	Описание
`protected View`	`layoutPool`	Это представления, которые соответствуют дочерним элементам элемента, представленного этим представлением (логическое представление, преобразуемое в физическое представление).
`protected int`	`layoutSpan`	Ограничение по умолчанию, используемое при создании потока.
`protected FlowView.FlowStrategy`	`strategy`	Поведение, определяющее, как поддерживать актуальность потока.

Поля, объявленные в классе View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Модификатор и тип	Поле	Описание
`static final int`	`BadBreakWeight`	Вес, указывающий, что представление является нежелательным местом переноса при форматировании.
`static final int`	`ExcellentBreakWeight`	Вес, указывающий, что представление поддерживает перенос и является очень подходящим местом для него.
`static final int`	`ForcedBreakWeight`	Вес, указывающий, что представление поддерживает перенос и должно быть разделено, чтобы его можно было правильно отобразить в представлении, форматирующем дочерние элементы путем их переноса.
`static final int`	`GoodBreakWeight`	Вес, указывающий, что представление поддерживает перенос, но, вероятно, существуют более подходящие места.
`static final int`	`X_AXIS`	Ось для операций форматирования и переноса.
`static final int`	`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

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM`	Константа ориентации контейнера, указывающая его нижнюю сторону.
`static final int`	`CENTER`	Центральное положение в области.
`static final int`	`EAST`	Направление по компасу: восток (вправо).
`static final int`	`HORIZONTAL`	Горизонтальная ориентация.
`static final int`	`LEADING`	Обозначает начальный край текста для языков с направлением письма слева направо и справа налево.
`static final int`	`LEFT`	Константа ориентации контейнера, указывающая его левую сторону.
`static final int`	`NEXT`	Обозначает следующее направление в последовательности.
`static final int`	`NORTH`	Направление по компасу: север (вверх).
`static final int`	`NORTH_EAST`	Направление по компасу: северо-восток (вверху справа).
`static final int`	`NORTH_WEST`	Направление по компасу: северо-запад (вверху слева).
`static final int`	`PREVIOUS`	Обозначает предыдущее направление в последовательности.
`static final int`	`RIGHT`	Константа ориентации контейнера, указывающая его правую сторону.
`static final int`	`SOUTH`	Направление по компасу: юг (вниз).
`static final int`	`SOUTH_EAST`	Направление по компасу: юго-восток (внизу справа).
`static final int`	`SOUTH_WEST`	Направление по компасу: юго-запад (внизу слева).
`static final int`	`TOP`	Константа ориентации контейнера, указывающая его верхнюю сторону.
`static final int`	`TRAILING`	Обозначает конечный край текста для языков с направлением письма слева направо и справа налево.
`static final int`	`VERTICAL`	Вертикальная ориентация.
`static final int`	`WEST`	Направление по компасу: запад (влево).

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

Конструктор	Описание
`ParagraphView(Element elem)`	Создает `ParagraphView` для указанного элемента.

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

Модификатор и тип	Метод	Описание
`View`	`breakView(int axis, float len, Shape a)`	Разбивает это представление по указанной оси на отрезке заданной длины.
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет потребности абзаца по малой оси.
`void`	`changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Получает уведомление от документа об изменении атрибутов в области, за которую отвечает это представление.
`protected View`	`createRow()`	Создает `View`, предназначенное для размещения ряда дочерних элементов в потоке.
`protected int`	`findOffsetToCharactersInString(char[] string, int start)`	Находит следующий символ в документе, имеющий символ в `string`, начиная со смещения `start`.
`protected boolean`	`flipEastAndWestAtEnds(int position, Position.Bias bias)`	Определяет направление расположения следующего представления.
`float`	`getAlignment(int axis)`	Определяет требуемое выравнивание этого представления вдоль оси.
`int`	`getBreakWeight(int axis, float len)`	Получает вес переноса для заданного расположения.
`protected int`	`getClosestPositionTo(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet, int rowIndex, int x)`	Возвращает ближайшую позицию модели к `x`.
`int`	`getFlowSpan(int index)`	Получает ограничивающий размер потока для указанного индекса дочернего элемента.
`int`	`getFlowStart(int index)`	Получает расположение вдоль оси потока, с которого начинается размер потока.
`protected View`	`getLayoutView(int index)`	Возвращает представление в заданном `index`.
`protected int`	`getLayoutViewCount()`	Возвращает количество представлений, за которые отвечает это представление.
`protected int`	`getNextNorthSouthVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Возвращает следующую визуальную позицию курсора в восточном или западном направлении.
`protected float`	`getPartialSize(int startOffset, int endOffset)`	Возвращает размер, используемый представлениями между `startOffset` и `endOffset`.
`protected float`	`getTabBase()`	Возвращает исходную точку, от которой вычисляются позиции табуляции.
`protected TabSet`	`getTabSet()`	Получает `Tabset`, используемый для вычисления позиций табуляции.
`float`	`nextTabStop(float x, int tabOffset)`	Возвращает позицию следующей табуляции относительно заданной опорной позиции.
`void`	`paint(Graphics g, Shape a)`	Выполняет отрисовку на заданной поверхности и в указанной области этой поверхности.
`protected void`	`setFirstLineIndent(float fi)`	Задает отступ первой строки.
`protected void`	`setJustification(int j)`	Задает тип выравнивания.
`protected void`	`setLineSpacing(float ls)`	Задает межстрочный интервал.
`protected void`	`setPropertiesFromAttributes()`	Задает кэшированные свойства на основе атрибутов.

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

getFlowAxis, getViewIndexAtPosition, insertUpdate, layout, loadChildren, removeUpdate

Модификатор и тип	Метод	Описание
`int`	`getFlowAxis()`	Получает ось, вдоль которой следует размещать представления в потоке.
`protected int`	`getViewIndexAtPosition(int pos)`	Получает индекс дочернего представления, соответствующий заданной позиции в модели.
`void`	`insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Получает уведомление о вставке чего-либо в документ в области, за которую отвечает это представление.
`protected void`	`layout(int width, int height)`	Выполняет компоновку дочерних элементов.
`protected void`	`loadChildren(ViewFactory f)`	Загружает все дочерние элементы для инициализации представления.
`void`	`removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Получает уведомление об удалении чего-либо из документа в области, за которую отвечает это представление.

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

baselineLayout, baselineRequirements, calculateMajorAxisRequirements, childAllocation, forwardUpdate, getAxis, getChildAllocation, getHeight, getMaximumSpan, getMinimumSpan, getOffset, getPreferredSpan, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paintChild, preferenceChanged, replace, setAxis, setSize, viewToModel

Модификатор и тип	Метод	Описание
`protected void`	`baselineLayout(int targetSpan, int axis, int[] offsets, int[] spans)`	Вычисляет расположение и размеры каждого дочернего представления в этом `BoxView` с учетом `targetSpan` — ширины (или высоты) доступной области.
`protected SizeRequirements`	`baselineRequirements(int axis, SizeRequirements r)`	Вычисляет требования к размеру этого `BoxView`, анализируя размеры каждого дочернего представления.
`protected SizeRequirements`	`calculateMajorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования к размеру по главной оси `axis`.
`protected void`	`childAllocation(int index, Rectangle alloc)`	Выделяет область для дочернего представления.
`protected void`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Передает заданное `DocumentEvent` дочерним представлениям, которые необходимо уведомить об изменении модели.
`int`	`getAxis()`	Получает свойство оси размещения.
`Shape`	`getChildAllocation(int index, Shape a)`	Получает выделенную область для указанного дочернего представления.
`int`	`getHeight()`	Возвращает текущую высоту контейнера.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль оси.
`protected int`	`getOffset(int axis, int childIndex)`	Получает смещение текущей компоновки конкретного дочернего элемента.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер этого представления вдоль оси.
`int`	`getResizeWeight(int axis)`	Получает вес изменения размера.
`protected int`	`getSpan(int axis, int childIndex)`	Получает размер текущей компоновки конкретного дочернего элемента.
`protected View`	`getViewAtPoint(int x, int y, Rectangle alloc)`	Получает дочернее представление по заданным координатам.
`int`	`getWidth()`	Возвращает текущую ширину контейнера.
`protected boolean`	`isAfter(int x, int y, Rectangle innerAlloc)`	Определяет, находится ли точка за пределами выделенной области.
`protected boolean`	`isAllocationValid()`	Остаются ли выделенные области дочерних элементов действительными?
`protected boolean`	`isBefore(int x, int y, Rectangle innerAlloc)`	Определяет, находится ли точка перед выделенной областью.
`protected boolean`	`isLayoutValid(int axis)`	Определяет, действительна ли компоновка вдоль указанной оси.
`void`	`layoutChanged(int axis)`	Сбрасывает действительность компоновки вдоль оси.
`protected void`	`layoutMajorAxis(int targetSpan, int axis, int[] offsets, int[] spans)`	Выполняет компоновку контейнера по главной оси (то есть по оси, которую он представляет).
`protected void`	`layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)`	Выполняет компоновку контейнера по малой оси (то есть по оси, перпендикулярной представляемой им оси).
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает преобразование координат из пространства модели документа в пространство координат соответствующего ей представления.
`protected void`	`paintChild(Graphics g, Rectangle alloc, int index)`	Отрисовывает дочерний элемент.
`void`	`preferenceChanged(View child, boolean width, boolean height)`	Вызывается дочерним элементом, чтобы сообщить об изменении его предпочтительного размера.
`void`	`replace(int index, int length, View[] elems)`	Сбрасывает действительность компоновки и изменяет размер кэша запросов и выделенных областей.
`void`	`setAxis(int axis)`	Задает свойство оси размещения.
`void`	`setSize(float width, float height)`	Задает размер представления.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Обеспечивает преобразование координат из пространства координат представления в логическое пространство координат модели.

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

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

Модификатор и тип	Метод	Описание
`protected short`	`getBottomInset()`	Получает нижнее внутреннее поле.
`protected Rectangle`	`getInsideAllocation(Shape a)`	Преобразует неизменяемую выделенную область, переданную представлению, в изменяемую область, соответствующую внутренней области (то есть границам заданной области за вычетом верхнего, левого, нижнего и правого внутренних полей).
`protected short`	`getLeftInset()`	Получает левое внутреннее поле.
`protected int`	`getNextEastWestVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Возвращает следующую визуальную позицию курсора в восточном или западном направлении.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующую визуально представленную позицию модели, в которой можно разместить курсор.
`protected short`	`getRightInset()`	Получает правое внутреннее поле.
`protected short`	`getTopInset()`	Получает верхнее внутреннее поле.
`View`	`getView(int n)`	Возвращает представление с номером n в этом контейнере.
`protected View`	`getViewAtPosition(int pos, Rectangle a)`	Получает дочернее представление, соответствующее заданной позиции в модели.
`int`	`getViewCount()`	Возвращает количество дочерних представлений этого представления.
`int`	`getViewIndex(int pos, Position.Bias b)`	Возвращает индекс дочернего представления, соответствующий заданной позиции в модели.
`Shape`	`modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)`	Обеспечивает преобразование координат из пространства модели документа в пространство координат соответствующего ей представления.
`protected void`	`setInsets(short top, short left, short bottom, short right)`	Задает внутренние поля представления.
`protected void`	`setParagraphInsets(AttributeSet attr)`	Задает внутренние поля на основе атрибутов абзаца, указанных в заданных атрибутах.
`void`	`setParent(View parent)`	Задает родительское представление.

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

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается разделить это представление по заданной оси.
`View`	`createFragment(int p0, int p1)`	Создает представление, соответствующее части элемента.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Передает `DocumentEvent` заданному дочернему представлению.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`int`	`getBreakWeight(int axis, float pos, float len)`	Определяет, насколько подходящим является место переноса в этом представлении.
`Container`	`getContainer()`	Получает контейнер, в котором размещено представление.
`Document`	`getDocument()`	Получает модель, связанную с представлением.
`Element`	`getElement()`	Получает структурную часть объекта, которой соответствует это представление.
`int`	`getEndOffset()`	Получает часть модели, за которую отвечает это представление.
`Graphics`	`getGraphics()`	Получает `Graphics` для отрисовки.
`View`	`getParent()`	Возвращает родительское представление.
`int`	`getStartOffset()`	Получает часть модели, за которую отвечает это представление.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Возвращает текст всплывающей подсказки в указанном месте.
`ViewFactory`	`getViewFactory()`	Получает реализацию `ViewFactory`, предоставляющую данные иерархии представлений.
`int`	`getViewIndex(float x, float y, Shape allocation)`	Возвращает индекс дочернего представления, соответствующий заданной позиции в представлении.
`void`	`insert(int offs, View v)`	Вставляет одно дочернее представление.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, видно ли представление.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`void`	`remove(int i)`	Удаляет одного из дочерних элементов в указанной позиции.
`void`	`removeAll()`	Удаляет все дочерние элементы.
`protected boolean`	`updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)`	Обновляет дочерние представления в ответ на уведомление об изменении модели, если имеется запись об изменении элемента, за который отвечает это представление.
`protected void`	`updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)`	Обновляет компоновку в ответ на уведомление модели об изменении.
`int`	`viewToModel(float x, float y, Shape a)`	Устарело.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Подробное описание полей

firstLineIndent

protected int firstLineIndent

Отступ первой строки от левого поля.

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

ParagraphView

public ParagraphView(Element elem)

Создает ParagraphView для указанного элемента.

Параметры:: elem — элемент, за который отвечает это представление

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

setJustification

protected void setJustification(int j)

Задает тип выравнивания.

Параметры:

j — одно из следующих значений:

StyleConstants.ALIGN_LEFT
StyleConstants.ALIGN_CENTER
StyleConstants.ALIGN_RIGHT

setLineSpacing

protected void setLineSpacing(float ls)

Задает межстрочный интервал.

Параметры:: ls — значение представляет собой коэффициент высоты строки

setFirstLineIndent

protected void setFirstLineIndent(float fi)

Задает отступ первой строки.

Параметры:: fi — значение в пунктах

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

Задает кэшированные свойства на основе атрибутов.

getLayoutViewCount

protected int getLayoutViewCount()

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

Возвращает:: количество представлений, за которые отвечает это ParagraphView

getLayoutView

protected View getLayoutView(int index)

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

Параметры:: index — index требуемого представления
Возвращает:: представление с индексом index

getNextNorthSouthVisualPositionFrom

protected int getNextNorthSouthVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet) throws BadLocationException

Возвращает следующую визуальную позицию курсора в восточном или западном направлении. Переопределен из CompositeView.

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

getNextNorthSouthVisualPositionFrom в классе CompositeView

Параметры:

pos — позиция в модели

b — либо Position.Bias.Forward, либо Position.Bias.Backward

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

direction — либо SwingConstants.NORTH, либо SwingConstants.SOUTH

biasRet — массив, содержащий смещения, проверенные этим методом

Возвращает:

позицию в модели, соответствующую следующей визуальной позиции

Вызывает:

BadLocationException — если указана недопустимая позиция в модели документа

См. также:

getClosestPositionTo

protected int getClosestPositionTo(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet, int rowIndex, int x) throws BadLocationException

Возвращает ближайшую позицию модели к x. rowIndex задает индекс соответствующего представления, в котором следует выполнить поиск.

Параметры:

pos — позиция в модели

b — смещение

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

direction — одно из следующих значений:

SwingConstants.NORTH
SwingConstants.SOUTH

biasRet — массив, содержащий смещения, проверенные этим методом

rowIndex — индекс представления

x — требуемая координата x

Возвращает:

ближайшую позицию модели к x

Вызывает:

BadLocationException — если обнаружена недопустимая позиция

flipEastAndWestAtEnds

protected boolean flipEastAndWestAtEnds(int position, Position.Bias bias)

Определяет направление расположения следующего представления. Рассмотрим View с индексом n. Обычно Views располагаются слева направо, поэтому View к ВОСТОКУ будет иметь индекс n + 1, а View к ЗАПАДУ — индекс n - 1. В некоторых случаях, например при двунаправленном тексте, View к ВОСТОКУ может иметь индекс не n + 1, а n - 1, либо View к ЗАПАДУ может иметь индекс не n - 1, а n + 1. В этом случае метод вернет true, указывая, что Views расположены в порядке убывания.

Метод вернет true, если текст в данной позиции расположен справа налево, иначе — false.

Переопределяет:: flipEastAndWestAtEnds в классе BoxView
Параметры:: position — позиция в модели; bias — либо Position.Bias.Forward, либо Position.Bias.Backward
Возвращает:: true, если текст в данной позиции расположен справа налево, иначе — false.

getFlowSpan

public int getFlowSpan(int index)

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

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

getFlowSpan в классе FlowView

Параметры:

index — индекс проверяемого представления

Возвращает:

ограничивающий интервал для указанного представления с индексом index

Начиная с версии:

1.3

См. также:

getFlowStart

public int getFlowStart(int index)

Получает координату на оси размещения, с которой начинается интервал размещения.

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

getFlowStart в классе FlowView

Параметры:

index — индекс проверяемого представления

Возвращает:

координату для указанного представления с индексом index

Начиная с версии:

1.3

См. также:

createRow

protected View createRow()

Создает View для размещения в строке дочерних элементов потока.

Определено в:: createRow в классе FlowView
Возвращает:: новое View
Начиная с версии:: 1.3

nextTabStop

public float nextTabStop(float x, int tabOffset)

Возвращает позицию следующей табуляции относительно заданной позиции. Это представление реализует систему координат табуляции и вызывает getTabbedSpan для логических дочерних элементов в процессе компоновки, чтобы определить требуемый интервал дочерних элементов. Логические дочерние элементы могут делегировать обработку табуляции абзацу, который знает, как расширять табуляцию. LabelView — пример представления, которое делегирует обработку табуляции абзацу.

Реализация пытается найти TabSet в наборе атрибутов элемента абзаца. Если такой объект найден, используются его настройки; в противном случае применяется расширение по умолчанию. Базовая координата для расширения табуляции — левое поле при последнем выделении абзацу (на основе которого выполняется компоновка дочерних элементов).

Определено в:

nextTabStop в интерфейсе TabExpander

Параметры:

x — опорная координата X

tabOffset — позиция табуляции в текстовом потоке >= 0

Возвращает:

конечную позицию расширения табуляции >= 0

См. также:

getTabSet

protected TabSet getTabSet()

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

Возвращает:: TabSet

getPartialSize

protected float getPartialSize(int startOffset, int endOffset)

Возвращает размер, занимаемый представлениями между startOffset и endOffset. Для вычисления размера используется getPartialView, если дочернее представление реализует интерфейс TabableView. Если размер необходим, а View не реализует интерфейс TabableView, будет использован preferredSpan.

Параметры:: startOffset — начальное смещение в документе >= 0; endOffset — конечное смещение в документе >= startOffset
Возвращает:: размер >= 0

findOffsetToCharactersInString

protected int findOffsetToCharactersInString(char[] string, int start)

Находит следующий символ в документе, совпадающий с символом из string, начиная со смещения start. Если символы не найдены, возвращается -1.

Параметры:: string — строка символов; start — начальная позиция в модели >= 0
Возвращает:: смещение в документе или -1, если символы не найдены

getTabBase

protected float getTabBase()

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

Возвращает:: базовую позицию для вычисления табуляции

paint

public void paint(Graphics g, Shape a)

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

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

paint в классе BoxView

Параметры:

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

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

См. также:

getAlignment

public float getAlignment(int axis)

Определяет требуемое выравнивание этого представления вдоль оси. Реализация задает выравнивание по центру первой строки вдоль оси y и выравнивание по умолчанию вдоль оси x.

Переопределяет:: getAlignment в классе BoxView
Параметры:: axis — может быть либо View.X_AXIS, либо View.Y_AXIS
Возвращает:: требуемое выравнивание. Значение должно находиться в диапазоне от 0.0 до 1.0 включительно: 0 означает выравнивание по началу координат, а 1.0 — выравнивание по концу полного интервала от начала координат. Значение 0.5 соответствует центру представления.

breakView

public View breakView(int axis, float len, Shape a)

Разбивает это представление вдоль заданной оси на указанной длине.

Экземпляры ParagraphView допускают разбиение только вдоль Y_AXIS и только в том случае, если len находится после первой строки.

Параметры:

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

len — задает желаемую позицию возможного разбиения вдоль указанной оси >= 0

a — текущая выделенная область представления

Возвращает:

фрагмент представления, соответствующий указанному интервалу, если представление допускает разбиение; если представление не поддерживает разбиение, возвращается само представление

См. также:

getBreakWeight

public int getBreakWeight(int axis, float len)

Возвращает вес разбиения для заданной позиции.

Экземпляры ParagraphView допускают разбиение только вдоль Y_AXIS и только в том случае, если len находится после первой строки. Если длина меньше одной строки, возвращается значение BadBreakWeight.

Параметры:

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

len — задает желаемую позицию возможного разбиения >= 0

Возвращает:

значение, указывающее целесообразность разбиения в этой позиции: либо GoodBreakWeight, либо BadBreakWeight

См. также:

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r)

Вычисляет требования абзаца по второстепенной оси.

Используются требования к размеру суперкласса, скорректированные с учетом неразбиваемых областей на границах соседних представлений. Минимальный размер таких представлений должен быть не меньше суммы всех соседних фрагментов.

Если параметр axis не равен ни View.X_AXIS, ни View.Y_AXIS, генерируется исключение IllegalArgumentException. Если параметр r равен null,, создается новый объект SizeRequirements; в противном случае возвращается переданный объект SizeRequirements.

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

calculateMinorAxisRequirements в классе FlowView

Параметры:

axis — второстепенная ось

r — входной объект SizeRequirements

Возвращает:

новый или скорректированный объект SizeRequirements

Вызывает:

IllegalArgumentException — если параметр axis имеет недопустимое значение

См. также:

changedUpdate

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

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

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

changedUpdate в классе FlowView

Параметры:

changes — сведения об изменении из связанного документа

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.