Класс BlockView

javax.swing.text.html.BlockView

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

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

public class BlockView extends BoxView

Реализация представления для отображения блока (в виде прямоугольника) с использованием спецификаций CSS.

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

Поля, объявленные в классе 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`	Направление по компасу: запад (влево).

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

Конструктор	Описание
`BlockView(Element elem, int axis)`	Создает новое представление, представляющее блок HTML.

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

Модификатор и тип	Метод	Описание
`protected SizeRequirements`	`calculateMajorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования блока вдоль основной оси (то есть оси, вдоль которой он укладывается).
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования блока вдоль второстепенной оси (то есть оси, перпендикулярной оси, вдоль которой он укладывается).
`float`	`getAlignment(int axis)`	Возвращает выравнивание.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер этого представления вдоль оси.
`int`	`getResizeWeight(int axis)`	Возвращает вес изменения размера.
`protected StyleSheet`	`getStyleSheet()`	Удобный метод для получения StyleSheet.
`protected void`	`layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)`	Выполняет компоновку прямоугольника по второстепенной оси (то есть оси, перпендикулярной представляемой оси).
`void`	`paint(Graphics g, Shape allocation)`	Выполняет отрисовку на указанной поверхности и в заданной области этой поверхности.
`void`	`setParent(View parent)`	Задает родительское представление для этого представления.
`protected void`	`setPropertiesFromAttributes()`	Обновляет все кэшированные значения, полученные из атрибутов.

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

baselineLayout, baselineRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAxis, getChildAllocation, getHeight, getOffset, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, 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 void`	`childAllocation(int index, Rectangle alloc)`	Выделяет область для дочернего представления.
`protected boolean`	`flipEastAndWestAtEnds(int position, Position.Bias bias)`	Определяет направление расположения следующего представления.
`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)`	Получает смещение текущей компоновки указанного дочернего элемента.
`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)`	Определяет, действительна ли компоновка вдоль указанной оси.
`protected void`	`layout(int width, int height)`	Выполняет компоновку прямоугольника
`void`	`layoutChanged(int axis)`	Помечает компоновку вдоль оси как недействительную.
`protected void`	`layoutMajorAxis(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, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, loadChildren, 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)`	Возвращает следующую визуальную позицию курсора в восточном или западном направлении.
`protected int`	`getNextNorthSouthVisualPositionFrom(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)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в модели.
`protected int`	`getViewIndexAtPosition(int pos)`	Получает индекс дочернего представления, соответствующего указанной позиции в модели.
`protected void`	`loadChildren(ViewFactory f)`	Загружает все дочерние элементы для инициализации представления.
`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, changedUpdate, createFragment, forwardUpdateToView, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, remove, removeAll, removeUpdate, updateChildren, updateLayout, viewToModel

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается разбить это представление по указанной оси.
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает от документа уведомление об изменении атрибутов в области, за которую отвечает это представление.
`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)`	Вставляет одно дочернее представление.
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление о вставке в документ в области, за которую отвечает это представление.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, видно ли представление.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`void`	`remove(int i)`	Удаляет один из дочерних элементов в указанной позиции.
`void`	`removeAll()`	Удаляет все дочерние элементы.
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление об удалении из документа в области, за которую отвечает это представление.
`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, либо до истечения заданного промежутка времени.

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

BlockView

public BlockView(Element elem, int axis)

Создает новое представление, отображающее блок HTML. Его можно использовать для множества элементов.

Параметры:: elem — элемент, для которого создается представление; axis — View.X_AXIS или View.Y_AXIS

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

setParent

public void setParent(View parent)

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

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

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

calculateMajorAxisRequirements

protected SizeRequirements calculateMajorAxisRequirements(int axis, SizeRequirements r)

Вычисляет требования блока вдоль главной оси (то есть оси, вдоль которой он располагается). Реализация обеспечивает поведение суперкласса, а затем корректирует его, если задан атрибут CSS width или height, применимый к этой оси.

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

calculateMajorAxisRequirements в классе BoxView

Параметры:

axis — изучаемая ось

r — объект SizeRequirements; если null, будет создан новый объект

Возвращает:

вновь инициализированный объект SizeRequirements

См. также:

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r)

Вычисляет требования блока вдоль второстепенной оси (то есть оси, перпендикулярной оси, вдоль которой он располагается). Реализация обеспечивает поведение суперкласса, а затем корректирует его, если задан атрибут CSS width или height, применимый к этой оси.

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

calculateMinorAxisRequirements в классе BoxView

Параметры:

axis — изучаемая ось

r — объект SizeRequirements; если null, будет создан новый объект

Возвращает:

вновь инициализированный объект SizeRequirements

См. также:

layoutMinorAxis

protected void layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)

Выполняет компоновку блока по второстепенной оси (то есть по оси, перпендикулярной представляемой им оси). Результаты компоновки (смещение и размер каждого дочернего представления) помещаются в указанные массивы, которые содержат выделенные дочерним представлениям области вдоль второстепенной оси.

Переопределяет:: layoutMinorAxis в классе BoxView
Параметры:: targetSpan — общая область, выделенная представлению и используемая для компоновки дочерних представлений; axis — компонуемая ось; offsets — смещения каждого дочернего представления относительно начала координат представления; это возвращаемое значение, заполняемое реализацией данного метода; spans — размеры каждого дочернего представления; это возвращаемое значение, заполняемое реализацией данного метода

paint

public void paint(Graphics g, Shape allocation)

Отрисовывает содержимое на заданной поверхности и в заданной области этой поверхности. Реализация делегирует отрисовку рамки и фона, предшествующую отрисовке внутреннего содержимого, средству отрисовки блоков CSS.

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

paint в классе BoxView

Параметры:

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

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

См. также:

getAttributes

public AttributeSet getAttributes()

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

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

getResizeWeight

public int getResizeWeight(int axis)

Возвращает вес изменения размера.

Переопределяет:: getResizeWeight в классе BoxView
Параметры:: axis — может быть X_AXIS или Y_AXIS
Возвращает:: вес
Вызывает исключение:: IllegalArgumentException — если ось недопустима

getAlignment

public float getAlignment(int axis)

Возвращает выравнивание.

Переопределяет:: getAlignment в классе BoxView
Параметры:: axis — может быть X_AXIS или Y_AXIS
Возвращает:: выравнивание

getPreferredSpan

public float getPreferredSpan(int axis)

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

Переопределяет:: getPreferredSpan в классе BoxView
Параметры:: axis — может быть View.X_AXIS или View.Y_AXIS
Возвращает:: размер области, в которой представление предпочитает быть отрисовано (>= 0); обычно представлению задают возвращаемый размер области для отрисовки, но это не гарантируется; родительское представление может изменить размер или разбить представление
Вызывает исключение:: IllegalArgumentException — если тип оси недопустим

getMinimumSpan

public float getMinimumSpan(int axis)

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

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

getMinimumSpan в классе BoxView

Параметры:

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

Возвращает:

размер области, в которой представление предпочитает быть отрисовано (>= 0); обычно представлению задают возвращаемый размер области для отрисовки, но это не гарантируется; родительское представление может изменить размер или разбить представление

Вызывает исключение:

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

См. также:

getMaximumSpan

public float getMaximumSpan(int axis)

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

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

getMaximumSpan в классе BoxView

Параметры:

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

Возвращает:

Вызывает исключение:

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

См. также:

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

Обновляет любые кэшированные значения, полученные из атрибутов.

getStyleSheet

protected StyleSheet getStyleSheet()

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

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

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