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

См. также:

IconView

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

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

Возвращает:

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

См. также:

JTextComponent.getToolTipText(java.awt.event.MouseEvent)

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 - фабрика, используемая для перестроения, если у вида есть дочерние элементы

См. также:

View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

paint

public void paint(Graphics g, Shape a)

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

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

paint в классе View

Параметры:

g - поверхность для рендеринга

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

См. также:

View.paint(java.awt.Graphics, java.awt.Shape)

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 - если заданная позиция не представляет допустимое местоположение в связанном документе

См. также:

View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

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

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

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

viewToModel в классе View

Параметры:

x - координата X

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

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

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

Возвращает:

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

См. также:

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

setSize

public void setSize(float width, float height)

Устанавливает размер вида. Это должно вызвать перерасчёт вида, если он имеет какие-либо задачи компоновки.

Переопределяет:: setSize в классе View
Параметры:: width - ширина, >= 0; height - высота, >= 0

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/text/html/ImageView.html