Класс ParagraphView

javax.swing.text.html.ParagraphView

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

public class ParagraphView extends ParagraphView

Отображает абзац и использует атрибуты CSS для его настройки.

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

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

FlowView.FlowStrategy

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

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

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

firstLineIndent

Модификатор и тип	Поле	Описание
`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 для указанного элемента.

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

Модификатор и тип	Метод	Описание
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет потребности абзаца вдоль второстепенной оси.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль заданной оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль заданной оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер этого представления.
`protected StyleSheet`	`getStyleSheet()`	Удобный метод для получения StyleSheet.
`boolean`	`isVisible()`	Указывает, следует ли отображать это представление.
`void`	`paint(Graphics g, Shape a)`	Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности.
`void`	`setParent(View parent)`	Задаёт родительское представление для этого представления.
`protected void`	`setPropertiesFromAttributes()`	Настраивает абзац на основе атрибутов CSS, а не значений из StyleConstants (которые использует суперкласс).

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

breakView, changedUpdate, createRow, findOffsetToCharactersInString, flipEastAndWestAtEnds, getAlignment, getBreakWeight, getClosestPositionTo, getFlowSpan, getFlowStart, getLayoutView, getLayoutViewCount, getNextNorthSouthVisualPositionFrom, getPartialSize, getTabBase, getTabSet, nextTabStop, setFirstLineIndent, setJustification, setLineSpacing

Модификатор и тип	Метод	Описание
`View`	`breakView(int axis, float len, Shape a)`	Разбивает это представление вдоль указанной оси на заданной длине.
`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)`	Возвращает позицию следующей табуляции относительно заданной опорной позиции.
`protected void`	`setFirstLineIndent(float fi)`	Задаёт отступ первой строки.
`protected void`	`setJustification(int j)`	Задаёт тип выравнивания.
`protected void`	`setLineSpacing(float ls)`	Задаёт межстрочный интервал.

Методы, объявленные в классе 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, getOffset, 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()`	Возвращает текущую высоту блока.
`protected int`	`getOffset(int axis, int childIndex)`	Получает смещение текущей компоновки указанного дочернего элемента.
`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

Модификатор и тип	Метод	Описание
`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)`	Задаёт поля на основе атрибутов абзаца, указанных в переданных атрибутах.

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

append, breakView, createFragment, forwardUpdateToView, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, 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` указанному дочернему представлению.
`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)`	Вставляет одно дочернее представление.
`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, либо до истечения заданного интервала реального времени.

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

ParagraphView

public ParagraphView(Element elem)

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

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

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

setParent

public void setParent(View parent)

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

Реализация перенаправляет вызов суперклассу, а также вызывает метод setPropertiesFromAttributes, чтобы задать свойства абзаца на основе атрибутов CSS. Вызов выполняется в этот момент, чтобы обеспечить возможность получения атрибутов представления от родительских представлений.

Переопределяет:: setParent в классе CompositeView
Параметры:: parent — новый родитель или null, если представление удаляется из родительского представления, к которому оно было ранее добавлено

getAttributes

public AttributeSet getAttributes()

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

Переопределяет:: getAttributes в классе View
Возвращает:: атрибуты, используемые при отображении

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

Настраивает абзац на основе атрибутов CSS, а не значений из StyleConstants (которые используются суперклассом). Поскольку

Переопределяет:: setPropertiesFromAttributes в классе ParagraphView

getStyleSheet

protected StyleSheet getStyleSheet()

Вспомогательный метод для получения таблицы стилей.

Возвращает:: таблицу стилей

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r)

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

Если требования к размеру абзаца заданы явно, используются эти требования. В противном случае используются требования суперкласса ParagraphView.

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

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

calculateMinorAxisRequirements в классе ParagraphView

Параметры:

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

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

Возвращает:

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

Исключения:

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

См. также:

isVisible

public boolean isVisible()

Показывает, должно ли отображаться это представление. Если ни одно из дочерних представлений не требует отображения и единственным видимым дочерним элементом является разрыв, завершающий абзац, абзац не будет считаться видимым. В противном случае он будет считаться видимым, и метод вернёт true.

Переопределяет:: isVisible в классе View
Возвращает:: true, если абзац должен отображаться

paint

public void paint(Graphics g, Shape a)

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

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

paint в классе ParagraphView

Параметры:

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

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

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет предпочтительный размер этого представления. Возвращает 0, если представление не является видимым; в противном случае вызывает метод суперкласса для получения предпочтительного размера по оси.

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

getPreferredSpan в классе BoxView

Параметры:

axis — может принимать значение View.X_AXIS или View.Y_AXIS

Возвращает:

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

См. также:

getMinimumSpan

public float getMinimumSpan(int axis)

Определяет минимальный размер этого представления вдоль оси. Возвращает 0, если представление не является видимым; в противном случае вызывает метод суперкласса для получения минимального размера.

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

getMinimumSpan в классе BoxView

Параметры:

axis — может принимать значение View.X_AXIS или View.Y_AXIS

Возвращает:

минимальный размер, в пределах которого можно отрисовать представление

См. также:

getMaximumSpan

public float getMaximumSpan(int axis)

Определяет максимальный размер этого представления вдоль оси. Возвращает 0, если представление не является видимым; в противном случае вызывает метод суперкласса для получения максимального размера.

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

getMaximumSpan в классе BoxView

Параметры:

axis — может принимать значение View.X_AXIS или View.Y_AXIS

Возвращает:

максимальный размер, в пределах которого можно отрисовать представление

См. также:

© 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.