Класс ListView

javax.swing.text.html.ListView

Все реализованные интерфейсы:: SwingConstants

public class ListView extends BlockView

Реализация представления для отображения HTML-списка

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

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

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

Конструктор	Описание
`ListView(Element elem)`	Создает новое представление, соответствующее элементу списка.

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

Модификатор и тип	Метод	Описание
`float`	`getAlignment(int axis)`	Вычисляет требуемую форму списка.
`void`	`paint(Graphics g, Shape allocation)`	Выполняет отрисовку на указанной поверхности и в указанной области этой поверхности.
`protected void`	`paintChild(Graphics g, Rectangle alloc, int index)`	Выполняет отрисовку одного из дочерних элементов; вызывается методом paint().

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

calculateMajorAxisRequirements, calculateMinorAxisRequirements, getAttributes, getMaximumSpan, getMinimumSpan, getPreferredSpan, getResizeWeight, getStyleSheet, layoutMinorAxis, setParent, setPropertiesFromAttributes

Модификатор и тип	Метод	Описание
`protected SizeRequirements`	`calculateMajorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования блока вдоль главной оси (то есть оси, вдоль которой он размещает элементы).
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)`	Вычисляет требования блока вдоль второстепенной оси (то есть оси, перпендикулярной оси, вдоль которой он размещает элементы).
`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`	`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, 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)`	Обеспечивает преобразование координат из пространства координат модели документа в пространство координат соответствующего ей представления.
`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, либо до истечения заданного промежутка реального времени.

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

ListView

public ListView(Element elem)

Создает новое представление, соответствующее элементу списка.

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

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

getAlignment

public float getAlignment(int axis)

Вычисляет требуемую форму списка.

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

getAlignment в классе BlockView

Параметры:

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

Возвращает:

требуемый размер

См. также:

paint

public void paint(Graphics g, Shape allocation)

Выполняет отрисовку на указанной поверхности и в указанной области этой поверхности.

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

paint в классе BlockView

Параметры:

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

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

См. также:

paintChild

protected void paintChild(Graphics g, Rectangle alloc, int index)

Выполняет отрисовку одного из дочерних элементов; вызывается методом paint(). По умолчанию это единственное, что делает данный метод, но подкласс может использовать его для отрисовки элементов относительно дочернего представления.

Переопределяет:: paintChild в классе BoxView
Параметры:: g — графический контекст; alloc — выделенная область для отрисовки дочернего элемента; index — индекс дочернего элемента

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