Класс ImageView

java.lang.Object

javax.swing.text.View

javax.swing.text.html.ImageView

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

public class ImageView extends View

Представление изображения, предназначенное для поддержки тега HTML <IMG>. Поддерживает масштабирование с помощью атрибутов HEIGHT и WIDTH тега. Если изображение не удаётся загрузить, будет отображён текст, указанный в атрибуте ALT.

Хотя этот класс уже давно входит в Swing, он стал общедоступным начиная с версии 1.4.

С версии:

1.4

См. также:

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

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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)`	Вызывается при изменении атрибутов элементов.
`float`	`getAlignment(int axis)`	Определяет желаемое выравнивание этого представления вдоль оси.
`String`	`getAltText()`	Возвращает текст, который следует отобразить, если изображение не удаётся загрузить.
`AttributeSet`	`getAttributes()`	Получает атрибуты, используемые при отрисовке.
`Image`	`getImage()`	Возвращает изображение для отрисовки.
`URL`	`getImageURL()`	Возвращает URL источника изображения или null, если его не удалось определить.
`Icon`	`getLoadingImageIcon()`	Возвращает значок, используемый во время загрузки изображения.
`boolean`	`getLoadsSynchronously()`	Возвращает `true`, если изображение следует загрузить при первом обращении к нему.
`Icon`	`getNoImageIcon()`	Возвращает значок, используемый, если изображение не удалось найти.
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительную протяжённость этого представления вдоль оси.
`protected StyleSheet`	`getStyleSheet()`	Удобный метод для получения StyleSheet.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Для изображений текст всплывающей подсказки берётся из текста, указанного в атрибуте `ALT`.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает отображение координатного пространства модели документа в координатное пространство соответствующего ей представления.
`void`	`paint(Graphics g, Shape a)`	Отрисовывает представление.
`void`	`setLoadsSynchronously(boolean newValue)`	Задаёт способ загрузки изображения.
`void`	`setParent(View parent)`	Устанавливает родительское представление для этого представления.
`protected void`	`setPropertiesFromAttributes()`	Обновляет кэшированные значения, полученные из атрибутов.
`void`	`setSize(float width, float height)`	Задаёт размер представления.
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)`	Обеспечивает отображение координатного пространства представления в логическое координатное пространство модели.

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

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, 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`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт заданное `DocumentEvent` дочерним представлениям, которые должны получить уведомление об изменении модели.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Передаёт `DocumentEvent` указанному дочернему представлению.
`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()`	Получает часть модели, за которую отвечает это представление.
`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)`	Заменяет дочерние представления.
`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, либо до истечения заданного интервала реального времени.

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

ImageView

public ImageView(Element elem)

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

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

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

getAltText

public String getAltText()

Возвращает текст для отображения, если изображение не удалось загрузить. Он извлекается из набора атрибутов элемента по имени атрибута HTML.Attribute.ALT.

Возвращает:: текст для отображения, если изображение не удалось загрузить.

getImageURL

public URL getImageURL()

Возвращает URL источника изображения или null, если его не удалось определить.

Возвращает:: URL источника изображения или null, если его не удалось определить.

getNoImageIcon

public Icon getNoImageIcon()

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

Возвращает:: значок, который используется, если изображение не удалось найти.

getLoadingImageIcon

public Icon getLoadingImageIcon()

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

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

getImage

public Image getImage()

Возвращает изображение для отрисовки.

Возвращает:: изображение для отрисовки.

setLoadsSynchronously

public void setLoadsSynchronously(boolean newValue)

Задает способ загрузки изображения. Если newValue имеет значение true, изображение будет загружено при первом запросе; в противном случае оно будет загружено асинхронно. По умолчанию синхронная загрузка не используется, то есть изображение загружается асинхронно.

Параметры:: newValue — если true, изображение будет загружено при первом запросе; в противном случае оно будет загружено асинхронно.

getLoadsSynchronously

public boolean getLoadsSynchronously()

Возвращает true, если изображение следует загружать при первом запросе.

Возвращает:: true, если изображение следует загружать при первом запросе.

getStyleSheet

protected StyleSheet getStyleSheet()

Удобный метод для получения StyleSheet.

Возвращает:: StyleSheet

getAttributes

public AttributeSet getAttributes()

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

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

getToolTipText

public String getToolTipText(float x, float y, Shape allocation)

Для изображений текст всплывающей подсказки берется из текста, заданного атрибутом ALT. Этот метод переопределен и возвращает getAltText.

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

getToolTipText в классе View

Параметры:

x — координата x

y — координата y

allocation — текущее пространство, выделенное для View.

Возвращает:

текст всплывающей подсказки в указанном месте

См. также:

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

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

setParent

public void setParent(View parent)

Задает родительское представление для этого представления. Использует эту возможность, чтобы сохранить ссылку на содержащий его контейнер AWT.

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

changedUpdate

public void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)

Вызывается при изменении атрибутов элемента. Повторно создает изображение.

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

changedUpdate в классе View

Параметры:

e — сведения об изменении из связанного документа

a — текущее пространство, выделенное для представления

f — фабрика для перестроения представления, если у него есть дочерние элементы

См. также:

paint

public void paint(Graphics g, Shape a)

Отрисовывает View.

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

paint в классе View

Параметры:

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

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

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

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

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

getAlignment

public float getAlignment(int axis)

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

Переопределяет:: getAlignment в классе View
Параметры:: axis — может иметь значение X_AXIS или Y_AXIS
Возвращает:: желаемое выравнивание; значение должно находиться в диапазоне от 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 — позиция для преобразования

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

y — координата Y

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

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

Возвращает:

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

См. также:

setSize

public void setSize(float width, float height)

Задает размер представления. Это должно приводить к компоновке представления, если она входит в его обязанности.

Переопределяет:: setSize в классе View
Параметры:: width — ширина >= 0; height — высота >= 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.