javax.swing.text.html
类 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) 当 Elements 属性已更改时调用。
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 的 Elements 属性集获取的。

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 多路传输模型中指定的属性。

覆盖：

类 View 中的 getAttributes

getToolTipText

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

对于图像，工具提示文本来自于 ALT 属性指定的文本。对其进行重写以返回 getAltText。

覆盖：

类 View 中的 getToolTipText

另请参见：

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

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

更新来自属性的任何缓存的值。

setParent

public void setParent(View parent)

建立此视图的父视图。此时应该缓存您所在的 AWT Container。

覆盖：

类 View 中的 setParent

参数：

parent - 新的父级，如果要从父级中移除视图，则为 null

changedUpdate

public void changedUpdate(DocumentEvent e,
                          Shape a,
                          ViewFactory f)

当 Elements 属性已更改时调用。重新创建图像。

覆盖：

类 View 中的 changedUpdate

参数：

e - 发自关联文档的更改信息

a - 视图的当前分配

f - 视图有子级时用于重建的工厂 View#changedUpdate

paint

public void paint(Graphics g,
                  Shape a)

绘制 View。

指定者：

类 View 中的 paint

参数：

g - 要使用的呈现表面

a - 分配的要在其中呈现的区域

另请参见：

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

getPreferredSpan

public float getPreferredSpan(int axis)

确定此视图沿某轴的首选区域。

指定者：

类 View 中的 getPreferredSpan

参数：

axis - 可以是 X_AXIS，也可以是 Y_AXIS

返回：

要呈现该视图的区域。通常会告知该视图在返回的区域中呈现，但不保证一定如此；父视图可以选择调整或拆分视图

另请参见：

View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)

确定此视图沿某个轴所需的调整值。实现此方法以使图标底部沿 y 轴对齐，而默认是沿 x 轴对齐。

覆盖：

类 View 中的 getAlignment

参数：

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

提供从文档模型坐标空间到所映射的视图坐标空间的映射。

指定者：

类 View 中的 modelToView

参数：

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)

提供从视图坐标空间到该模型的逻辑坐标空间的映射。

指定者：

类 View 中的 viewToModel

参数：

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)

设置视图的大小。如果此方法有任何布局任务，则会导致布局视图。

覆盖：

类 View 中的 setSize

参数：

width - 宽度，其值 >= 0

height - 高度，其值 >= 0