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

См. также:

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

Поля, объявленные в классе javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Поля, объявленные в интерфейсе javax.swing.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)`	Отображает View.
`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)`	Обеспечивает отображение из пространства координат представления в логическое пространство координат модели.

Методы, объявленные в классе javax.swing.text.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

Методы, объявленные в классе java.lang.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()

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

Возвращает:: стиль

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/html/ImageView.html