Класс 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()`	Удобный метод для получения таблицы стилей.
`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 изображение загрузится при первом запросе, в противном случае — асинхронно.

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, 2023, 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/21/docs/api/java.desktop/javax/swing/text/html/ImageView.html