Класс 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

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, 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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

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()

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

Переопределяет:: 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)

Отображает представление.

Определён в:

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/html/ImageView.html