Класс IconView

java.lang.Object

javax.swing.text.View

javax.swing.text.IconView

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

public class IconView extends View

Декоратор значка, реализующий интерфейс представления. Для представления значка используется весь элемент. Он служит связующим звеном между реализациями View, предназначенными только для отображения, и интерактивными лёгкими значками (то есть позволяет встраивать значки в иерархию View). Родителем значка является контейнер, предоставляемый связанной фабрикой представлений.

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

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

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

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

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

Модификатор и тип	Метод	Описание
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание этого представления вдоль оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительный размер этого представления вдоль оси.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает преобразование координат из пространства координат модели документа в пространство координат соответствующего ей представления.
`void`	`paint(Graphics g, Shape a)`	Отрисовывает значок.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Обеспечивает преобразование координат из пространства координат представления в логическое пространство координат модели.

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

append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setParent, setSize, 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`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт указанный `DocumentEvent` дочерним представлениям, которые должны получить уведомление об изменении модели.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт `DocumentEvent` указанному дочернему представлению.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`int`	`getBreakWeight(int axis, float pos, float len)`	Определяет привлекательность места разрыва в этом представлении.
`Shape`	`getChildAllocation(int index, Shape a)`	Получает область размещения указанного дочернего представления.
`Container`	`getContainer()`	Получает контейнер, в котором размещено представление.
`Document`	`getDocument()`	Получает модель, связанную с представлением.
`Element`	`getElement()`	Получает структурную часть объекта, с которым связано это представление.
`int`	`getEndOffset()`	Получает часть модели, за которую отвечает это представление.
`Graphics`	`getGraphics()`	Получает `Graphics` для отрисовки.
`float`	`getMaximumSpan(int axis)`	Определяет максимальный размер этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальный размер этого представления вдоль оси.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующее визуально представленное расположение модели, в котором можно разместить курсор.
`View`	`getParent()`	Возвращает родительское представление.
`int`	`getResizeWeight(int axis)`	Определяет возможность изменения размера представления вдоль указанной оси.
`int`	`getStartOffset()`	Получает часть модели, за которую отвечает это представление.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Возвращает текст подсказки в указанном месте.
`View`	`getView(int n)`	Получает n-е дочернее представление.
`int`	`getViewCount()`	Возвращает количество представлений в этом представлении.
`ViewFactory`	`getViewFactory()`	Получает реализацию `ViewFactory`, обеспечивающую работу иерархии представлений.
`int`	`getViewIndex(float x, float y, Shape allocation)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в представлении.
`int`	`getViewIndex(int pos, Position.Bias b)`	Возвращает индекс дочернего представления, соответствующего указанной позиции в модели.
`void`	`insert(int offs, View v)`	Вставляет одно дочернее представление.
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление о том, что в документ в области, за которую отвечает это представление, был вставлен объект.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, видно ли представление.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`Shape`	`modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)`	Для указанной области преобразует координаты из пространства координат модели документа в пространство координат представления.
`void`	`preferenceChanged(View child, boolean width, boolean height)`	Дочерние представления могут вызвать этот метод у родительского, чтобы сообщить об изменении предпочтения, которое следует учесть при повторной компоновке.
`void`	`remove(int i)`	Удаляет одного из дочерних элементов в указанной позиции.
`void`	`removeAll()`	Удаляет все дочерние элементы.
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Получает уведомление о том, что из документа в области, за которую отвечает это представление, был удалён объект.
`void`	`replace(int offset, int length, View[] views)`	Заменяет дочерние представления.
`void`	`setParent(View parent)`	Задаёт родительское представление для этого представления.
`void`	`setSize(float width, float height)`	Задаёт размер представления.
`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()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова метода уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова метода уведомления или прерывания, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова метода уведомления или прерывания, либо до истечения заданного интервала реального времени.

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

IconView

public IconView(Element elem)

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

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

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

paint

public void paint(Graphics g, Shape a)

Отрисовывает значок. Фактическая отрисовка естественным образом выполняется благодаря связи значка с родительским контейнером (тем же контейнером, в котором размещено это представление), поэтому этот метод лишь позволяет правильно расположить значок относительно представления. Поскольку система координат представления совпадает с системой координат родительского контейнера, разместить дочерний значок несложно.

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

paint в классе View

Параметры:

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

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

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

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

Определено в:: getPreferredSpan в классе View
Параметры:: axis — может быть View.X_AXIS или View.Y_AXIS
Возвращает:: размер, в пределах которого представление предпочитает отрисовываться. Обычно представлению предписывается отрисовываться в пределах возвращённого размера, однако это не гарантируется. Родительское представление может изменить размер или разбить это представление.
Выбрасывает:: IllegalArgumentException — если указана недопустимая ось

getAlignment

public float getAlignment(int axis)

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

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

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

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

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

modelToView в классе View

Параметры:

pos — позиция для преобразования >= 0

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

b — смещение в сторону предыдущего или следующего символа, представленного смещением, если позиция является границей двух представлений; b может принимать одно из следующих значений:

Position.Bias.Forward
Position.Bias.Backward

Возвращает:

ограничивающий прямоугольник указанной позиции

Выбрасывает:

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

См. также:

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)

Обеспечивает преобразование координат из пространства координат представления в логическое пространство координат модели.

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

viewToModel в классе View

Параметры:

x — координата X >= 0

y — координата Y >= 0

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

bias — возвращаемое смещение

Возвращает:

позиция в модели, наилучшим образом соответствующая указанной точке представления >= 0

См. также:

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