JavaTM Platform
Standard Ed. 6

javax.swing.text
类 IconView

java.lang.Object
  继承者 javax.swing.text.View
      继承者 javax.swing.text.IconView
所有已实现的接口:
SwingConstants

public class IconView
extends View

实现视图接口的图标修饰符。使用整个元素表示该图标。此方法充当一个从只显示 View 实现到交互式轻量级图标的门户(也就是说,它允许将图标嵌入 View 层次结构中。图标的父级是由相关视图工厂提供的容器。


字段摘要
 
从类 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
 
构造方法摘要
IconView(Element elem)
          创建表示元素的新图标视图。
 
方法摘要
 float getAlignment(int axis)
          确定此视图沿某个轴所需的调整值。
 float getPreferredSpan(int axis)
          确定此视图沿某个轴的首选区域。
 Shape modelToView(int pos, Shape a, Position.Bias b)
          提供从文档模型坐标空间到所映射的视图坐标空间的映射。
 void paint(Graphics g, Shape a)
          绘制图标。
 int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
          提供从视图坐标空间到该模型的逻辑坐标空间的映射。
 
从类 javax.swing.text.View 继承的方法
append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setParent, setSize, updateChildren, updateLayout, viewToModel
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

IconView

public IconView(Element elem)
创建表示元素的新图标视图。

参数:
elem - 要为其创建视图的元素
方法详细信息

paint

public void paint(Graphics g,
                  Shape a)
绘制图标。实际绘制行为自然会从该图标与其父容器(承载此视图的同一个容器)的关联中发生,因此,这只允许相对于该视图正确定位图标。因为该视图的坐标系就是父容器,所以定位子图标很容易。

指定者:
View 中的 paint
参数:
g - 要使用的呈现表面
a - 分配的要在其中呈现的区域
另请参见:
View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)
确定此视图沿某个轴的首选区域。

指定者:
View 中的 getPreferredSpan
参数:
axis - 可以是 View.X_AXIS,也可以是 View.Y_AXIS
返回:
要呈现该视图的区域。通常会告知该视图在返回的区域中呈现,但不保证一定如此。父级可选择重新调整视图大小或拆分视图。
抛出:
IllegalArgumentException - 如果轴无效
另请参见:
View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)
确定此视图沿某个轴所需的调整值。实现此方法以使图标底部沿 y 轴对齐,而默认是沿 x 轴对齐。

覆盖:
View 中的 getAlignment
参数:
axis - 可以是 View.X_AXIS,也可以是 View.Y_AXIS
返回:
所需的调整值,该值 >= 0.0f 且 <= 1.0f。这应该是介于 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 - 要转换的位置,其值 >= 0
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 坐标,该值 >= 0
y - Y 坐标,该值 >= 0
a - 要在其中呈现的分配区域
返回:
模型中最能代表视图中给定点的位置,该值 >= 0
另请参见:
View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

JavaTM Platform
Standard Ed. 6

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

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