Класс 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.
Возвращает:
текст всплывающей подсказки в указанном месте
См. также:
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
Возвращает:
размер, который представление хотело бы получить для отрисовки; обычно представлению говорят отрисовываться в этот размер, хотя нет гарантий; родитель может изменить или разбить представление
См. также:
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 - выделенная область для отрисовки
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, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/text/html/ImageView.html

Spec-Zone .ru
спецификации, руководства, описания, API