Module java.desktop

软件包 javax.swing.text

Class IconView

java.lang.Object

javax.swing.text.View

javax.swing.text.IconView

All Implemented Interfaces:

SwingConstants

public class IconView
extends View

图标装饰器实现视图界面。 整个元素用于表示图标。 这是从仅显示View实现到交互式轻量级图标的网关（即，它允许将图标嵌入到View层次结构中）。图标的父级是相关视图工厂发出的容器。

Field Summary

Fields inherited from interface 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

Fields inherited from class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

构造方法摘要

构造方法

Constructor	描述
IconView(Element elem)	创建一个代表元素的新图标视图。

方法摘要

Modifier and Type	方法	描述
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)	提供从视图坐标空间到模型的逻辑坐标空间的映射。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class 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

构造方法详细信息

IconView

public IconView(Element elem)

创建一个代表元素的新图标视图。

参数

elem - 为其创建视图的元素

方法详细信息

paint

public void paint(Graphics g,
                  Shape a)

画图标。 真正的绘画行为自然地发生在图标与其父容器（托管此视图的同一容器）的关联中，因此这简单地允许我们相对于视图正确定位图标。 由于视图的坐标系仅仅是父容器，所以定位子图标很容易。

Specified by:

paint在 View

参数

g - 要使用的渲染表面

a - 要分配的区域

另请参见：

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

getPreferredSpan

public float getPreferredSpan(int axis)

确定沿着轴的此视图的首选跨度。

Specified by:

getPreferredSpan在 View

参数

axis - 可以是View.X_AXIS或View.Y_AXIS

结果

视图想要渲染的跨度通常，视图被呈现到返回的跨度，尽管不能保证。 父母可以选择调整大小或打破视图。

异常

IllegalArgumentException - 对于无效的轴

另请参见：

View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)

确定沿着轴的该视图的所需对准。 这是为了给出沿着y轴的图标底部的对齐方式，并且沿着x轴的默认值。

重写：

getAlignment在 View

参数

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

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

Specified by:

modelToView在 View

参数

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)

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

Specified by:

viewToModel在 View

参数

x - X坐标> = 0

y - Y坐标> = 0

a - 要分配的区域

bias - 返回的偏差

结果

模型中最能代表给定观点的位置> = 0

另请参见：

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])