Класс ObjectView

javax.swing.text.html.ObjectView

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

public class ObjectView extends ComponentView

Декоратор компонента, реализующий интерфейс представления для элементов <object>.

Это представление попытается загрузить класс, указанный в атрибуте classid. Если возможно, используется ClassLoader, применённый для загрузки связанного документа. Обычно это тот же ClassLoader, который использовался для загрузки EditorKit. Если ClassLoader документа равен null, используется Class.forName.

Если класс удалось успешно загрузить, будет предпринята попытка создать его экземпляр вызовом Class.newInstance. Затем будет предпринята попытка привести экземпляр к типу java.awt.Component, чтобы отобразить объект.

Это представление также может управлять набором параметров с ограничениями. Предполагается, что параметры элемента <object> представлены в наборе атрибутов связанных элементов в виде простых строк. Каждое свойство bean-компонента будет использоваться как ключ в AttributeSet; предполагается, что для свойства, если для него задан параметр, будет присутствовать ненулевое значение (типа String). Для установки параметра используется рефлексия. В настоящее время поддерживается только очень простой одиночный параметр типа String.

Пример простого вызова HTML:

     <object classid="javax.swing.JLabel">
     <param name="text" value="sample text">
     </object>

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

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

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

Конструктор	Описание
`ObjectView(Element elem)`	Создаёт новый объект ObjectView.

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

Модификатор и тип	Метод	Описание
`protected Component`	`createComponent()`	Создаёт компонент.

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

getAlignment, getComponent, getMaximumSpan, getMinimumSpan, getPreferredSpan, modelToView, paint, setParent, viewToModel

Модификатор и тип	Метод	Описание
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание этого представления вдоль оси.
`final Component`	`getComponent()`	Получает компонент, связанный с представлением.
`float`	`getMaximumSpan(int axis)`	Определяет максимальную протяжённость этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальную протяжённость этого представления вдоль оси.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительную протяжённость этого представления вдоль оси.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Предоставляет преобразование координат из пространства модели в пространство представления.
`void`	`paint(Graphics g, Shape a)`	Отрисовка фактически выполняется автоматически благодаря связи компонента с родительским контейнером (тем же контейнером, в котором размещено это представление).
`void`	`setParent(View p)`	Задаёт родителя для дочернего представления.
`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, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, 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` для отрисовки.
`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`	`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()`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

ObjectView

public ObjectView(Element elem)

Создаёт новый объект ObjectView.

Параметры:: elem — элемент для декорирования

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

createComponent

protected Component createComponent()

Создаёт компонент. classid используется в качестве спецификации имени класса, который мы пытаемся загрузить.

Переопределяет:: createComponent в классе ComponentView
Возвращает:: компонент, связанный с этим представлением

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