JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策