javax.swing.text

Class ComponentView

java.lang.Object

javax.swing.text.View

javax.swing.text.ComponentView

All Implemented Interfaces:

SwingConstants

已知直接子类：

FormView， ObjectView

public class ComponentView
extends View

组件设计师实现视图界面。整个元素被用来表示组件。作为一个网关，从只显示视图实现交互式轻量级组件（即它允许嵌入到视图层次结构的组件）。

元件放置相对于文本基线根据返回的值Component.getAlignmentY。swing组件这个值可以方便的设置使用方法JComponent.setAlignmentY。例如，设定值0.75将导致组件百分之75是基线以上，和百分之25的分量要低于基线。

该类实现了在多线程（即从模型更改的异步通知）的存在下工作的额外的工作（例如，通过对事件线程上的所有组件访问）确保所需的额外工作。

所使用的组件是由createcomponent方法的返回值确定。此方法的默认实现是返回举行作为元素的属性的组件（通过调用styleconstants。GetComponent）。这种行为的一个限制是，该组件不能使用一个以上的文本组件（即与共享模型）。子类可以通过实施createcomponent实际创建一个组件基于某种规范包含在属性中删除此约束。在HTML包装objectview类是一个支持共享模型的多成分的观点componentview实施例。

Field Summary

Fields inherited from class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

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

构造方法摘要

构造方法

Constructor and Description
ComponentView(Element elem) 创建一个新的componentview对象。

方法摘要

Modifier and Type	Method and Description
protected Component	createComponent() 创建与此视图关联的组件。
float	getAlignment(int axis) 沿着一个轴确定此视图所需的对齐方式。
Component	getComponent() 获取与视图关联的组件。
float	getMaximumSpan(int axis) 沿着一个轴确定该视图的最大跨度。
float	getMinimumSpan(int axis) 沿着一个轴确定该视图的最小间距。
float	getPreferredSpan(int axis) 沿着一个轴确定该视图的首选跨度。
Shape	modelToView(int pos, Shape a, Position.Bias b) 从模型的坐标空间提供了一个映射到视图的映射。
void	paint(Graphics g, Shape a) 真正的油漆行为自然发生的关联，该组件已与它的父容器（同一个容器承载此视图）。
void	setParent(View p) 为子视图设置父视图。
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias) 从视图坐标空间提供一个映射到模型的逻辑坐标空间。

Methods inherited from class javax.swing.text.View

append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setSize, updateChildren, updateLayout, viewToModel

Methods inherited from class java.lang.Object

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

Constructor Detail

ComponentView

public ComponentView(Element elem)

创建一个新的componentview对象。

参数

elem -元素装饰

方法详细信息

createComponent

protected Component createComponent()

创建与此视图关联的组件。这将被调用时，它已被确定，一个新的组件是必要的。这Setparent会导致调用或由于被通知属性已经改变。

getComponent

public final Component getComponent()

获取与视图关联的组件。

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)

沿着一个轴确定该视图的首选跨度。这是实现返回值以及感兴趣的轴component.getpreferredsize返回。

Specified by:

getPreferredSpan 方法重写，继承类 View

参数

axis -可能是view.x_axis或view.y_axis

结果

跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。

异常

IllegalArgumentException -无效的轴

另请参见：

View.getPreferredSpan(int)

getMinimumSpan

public float getMinimumSpan(int axis)

沿着一个轴确定该视图的最小间距。这是实现返回值以及感兴趣的轴component.getminimumsize返回。

重写：

getMinimumSpan 方法重写，继承类 View

参数

axis -可能是view.x_axis或view.y_axis

结果

跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。

异常

IllegalArgumentException -无效的轴

另请参见：

View.getPreferredSpan(int)

getMaximumSpan

public float getMaximumSpan(int axis)

沿着一个轴确定该视图的最大跨度。这是实现返回值以及感兴趣的轴component.getmaximumsize返回。

重写：

getMaximumSpan 方法重写，继承类 View

参数

axis -可能是view.x_axis或view.y_axis

结果

跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。

异常

IllegalArgumentException -无效的轴

另请参见：

View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)

沿着一个轴确定此视图所需的对齐方式。这是实现给嵌入式组件的对准。

重写：

getAlignment 方法重写，继承类 View

参数

axis -可能是view.x_axis或view.y_axis

结果

所需的对准。这应该是一个值在0和1之间，其中0表示对准在原点和1表示对齐到完整的距离远离原点。0.5的对齐方式将是视图的中心。

setParent

public void setParent(View p)

为子视图设置父视图。父母调用这个子来告诉它父是谁，给视图访问像主机容器这样的东西。父类的行为被执行，接着一个电话createcomponent如果父视图参数是非零和一部分尚未建立。嵌入式组件的父母将返回的值 getContainer。如果父视图参数为空，这一观点被清理干净，这样的组件是从其母删除。

组件层次结构的更改将触摸组件锁，这是从视图层次结构中不安全的一个。因此，如果在事件线程上执行此功能，或在事件队列中调用另一个线程（从异步更新通知更改），则将立即执行此功能。

重写：

setParent 方法重写，继承类 View

参数

p -母

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 -分配区域进行渲染

结果

最佳表示视图中给定的点的模型中的位置

另请参见：

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