Класс 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, если он не может быть определён.

getNoImageIcon

public Icon getNoImageIcon()

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

getLoadingImageIcon

public Icon getLoadingImageIcon()

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

getImage

public Image getImage()

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

setLoadsSynchronously

public void setLoadsSynchronously(boolean newValue)

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

getLoadsSynchronously

public boolean getLoadsSynchronously()

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

getStyleSheet

protected StyleSheet getStyleSheet()

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

getAttributes

public AttributeSet getAttributes()

Извлекает атрибуты, используемые при отрисовке. Это реализовано для объединения атрибутов, указанных в модели, со StyleSheet.

Переопределяет:: getAttributes в классе View

getToolTipText

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

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

Переопределяет:: getToolTipText в классе 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)

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

Задано:: 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
Возвращает:: размер, который представление хотело бы занять; обычно представлению говорят заполнить возвращенным размером, хотя это не гарантируется; родитель может выбрать изменение или разбиение представления
См. также:: View.getPreferredSpan(int)

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 - выделенная область для отрисовки
Возвращает:: местоположение в модели, которое лучше всего представляет заданную точку представления
См. также:: 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, 2020, 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.