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[])