当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
javax.swing.text
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
CompositeView (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.swing.text
类 CompositeView
java.lang.Objectjavax.swing.text.View
- 所有已实现的接口：
- SwingConstants
- 直接已知子类：
- BoxView
public abstract class CompositeView
- extends View
CompositeView 是一个管理着一个或多个子视图的抽象 View 实现。（注意，CompositeView 主要管理相对较少的子视图。）CompositeView 主要充当 View 实现的起点，例如 BoxView，它将包含子 View。要管理子 View 集的子类应使用 replace(int, int, javax.swing.text.View[]) 方法。由于 View 在 DocumentListener 通知过程中调用 replace，所以通常不需要直接调用 replace。
虽然 CompositeView 不会对其子 View 施加布局策略，但它允许插入将包含的子 View。插入内容可通过 setInsets(short, short, short, short) 或 setParagraphInsets(javax.swing.text.AttributeSet) 进行设置。
除了 View 的抽象方法之外，CompositeView 的子类还需要重写：
isBefore(int, int, java.awt.Rectangle)- 用于测试给定的View位置是否位于CompositeView的可视空间之前。isAfter(int, int, java.awt.Rectangle)- 用于测试给定的View位置是否位于CompositeView的可视空间之后。getViewAtPoint(int, int, java.awt.Rectangle)- 返回位于给定可视位置的视图。childAllocation(int, java.awt.Rectangle)- 返回特定子View的边界。getChildAllocation在其边界减去CompositeView的Inset之后，将调用childAllocation。
| 字段摘要 |
|---|
| 从类 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 |
| 构造方法摘要 | |
|---|---|
CompositeView(Element elem)
为给定元素构造一个 CompositeView。 |
|
| 方法摘要 | |
|---|---|
protected abstract void |
childAllocation(int index,
Rectangle a)
返回给定子级的分配区域。 |
protected boolean |
flipEastAndWestAtEnds(int position,
Position.Bias bias)
确定下一个视图放置的朝向。 |
protected short |
getBottomInset()
获取底部 inset。 |
Shape |
getChildAllocation(int index,
Shape a)
获取要在其中呈现的给定子视图的分配区域。 |
protected Rectangle |
getInsideAllocation(Shape a)
将分配给视图的不可变分配区域转换为表示内部分配区域的可变分配区域（即给定分配区域的边界，其顶部、左部、底部和右部的 insets 已移除）。 |
protected short |
getLeftInset()
获取左部 inset。 |
protected int |
getNextEastWestVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
返回光标的下一个可视位置，可以在东或在西。 |
protected int |
getNextNorthSouthVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
返回光标的下一个可视位置，可以在北也可以在南。 |
int |
getNextVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
提供一种方法来确定下一个以可视化形式表示的模型位置，用户可以在此位置放置一个插入符。 |
protected short |
getRightInset()
获取右部 inset。 |
protected short |
getTopInset()
获取顶部 inset。 |
View |
getView(int n)
返回该容器中的第 n 个视图。 |
protected abstract View |
getViewAtPoint(int x,
int y,
Rectangle alloc)
获取位于给定坐标的子视图。 |
protected View |
getViewAtPosition(int pos,
Rectangle a)
获取表示模型中给定位置的子视图。 |
int |
getViewCount()
返回此视图的子视图数。 |
int |
getViewIndex(int pos,
Position.Bias b)
返回表示模型中给定位置的子视图索引。 |
protected int |
getViewIndexAtPosition(int pos)
获取表示模型中给定位置的子视图索引。 |
protected abstract boolean |
isAfter(int x,
int y,
Rectangle alloc)
测试一个点是否位于矩形范围之后。 |
protected abstract boolean |
isBefore(int x,
int y,
Rectangle alloc)
测试一个点是否位于矩形范围之前。 |
protected void |
loadChildren(ViewFactory f)
加载所有的子级以初始化该视图。 |
Shape |
modelToView(int p0,
Position.Bias b0,
int p1,
Position.Bias b1,
Shape a)
提供从文档模型坐标空间到所映射的视图坐标空间的映射。 |
Shape |
modelToView(int pos,
Shape a,
Position.Bias b)
提供从文档模型坐标空间到所映射的视图坐标空间的映射。 |
void |
replace(int offset,
int length,
View[] views)
替换子视图。 |
protected void |
setInsets(short top,
short left,
short bottom,
short right)
设置视图的 insets。 |
protected void |
setParagraphInsets(AttributeSet attr)
按照给定属性中指定的段落属性设置 insets。 |
void |
setParent(View parent)
设置此视图的父级。 |
int |
viewToModel(float x,
float y,
Shape a,
Position.Bias[] bias)
提供从视图坐标空间到模型的逻辑坐标空间的映射。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| 构造方法详细信息 |
|---|
CompositeView
public CompositeView(Element elem)
- 为给定元素构造一个
CompositeView。- 参数：
elem- 此视图负责的元素
| 方法详细信息 |
|---|
loadChildren
protected void loadChildren(ViewFactory f)
- 加载所有的子级以初始化该视图。它由
setParent(javax.swing.text.View)方法调用。子类可重新实现它以便按不同的方式初始化其子视图。默认实现为每个子元素创建一个子视图。- 参数：
f- 视图工厂- 另请参见：
setParent(javax.swing.text.View)
setParent
public void setParent(View parent)
- 设置此视图的父级。重新实现此方法可提供超类行为，并可在此视图无子级的情况下调用
loadChildren方法。不应在构造方法中加载子级，因为设置父级的动作可能引起它们试图沿层次结构向上搜索，例如，要获得承载Container。如果此视图有子级（视图从视图层次结构中的一个位置移动到另一个位置），则不调用loadChildren方法。- 参数：
parent- 视图的父级，如果没有则为null
getViewCount
public int getViewCount()
- 返回此视图的子视图数。
- 覆盖：
- 类
View中的getViewCount
- 返回：
- 视图数，该数量 >= 0
- 另请参见：
getView(int)
getView
public View getView(int n)
replace
public void replace(int offset,
int length,
View[] views)
- 替换子视图。如果没有要移除的视图，此方法视为插入操作。如果没有要添加的视图，此方法视为移除操作。被移除的视图的父级将被设置为
null，并且移除了对它们的内部引用，所以它们有可能被作为垃圾回收。- 参数：
offset- 要插入新视图的子视图的起始索引；该索引 >= 0 且 <= getViewCountlength- 要移除的现有子视图数；此值应 >= 0 且 <= (getViewCount() - offset)views- 要添加的子视图；此值可以为null，表示不添加任何子级（对移除有用）
getChildAllocation
public Shape getChildAllocation(int index, Shape a)
- 获取要在其中呈现的给定子视图的分配区域。这有助于获得各个视图所处的位置。
- 覆盖：
- 类
View中的getChildAllocation
- 参数：
index- 子级的索引，该索引 >= 0 且 < getViewCount()a- 对此视图的分配区域- 返回：
- 子级的分配区域
modelToView
public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException
- 提供从文档模型坐标空间到所映射的视图坐标空间的映射。
- 指定者：
- 类
View中的modelToView
- 参数：
pos- 要转换的位置，该位置 >= 0a- 要在其中呈现的已分配区域b- 一个偏移值，可以是Position.Bias.Forward或Position.Bias.Backward- 返回：
- 给定位置的边界框
- 抛出：
BadLocationException- 如果给定位置不是相关文档中的有效位置- 另请参见：
View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)
modelToView
public Shape modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a) throws BadLocationException
- 提供从文档模型坐标空间到所映射的视图坐标空间的映射。
- 覆盖：
- 类
View中的modelToView
- 参数：
p0- 要转换的位置，该位置 >= 0b0- 由 p0 表示的上一字符或下一个字符的偏移量，在这种情况下，该位置是两个视图的边界；既可以是Position.Bias.Forward，也可以是Position.Bias.Backwardp1- 要转换的位置，该位置 >= 0b1- 由 p1 表示的上一字符或下一个字符的偏移量，在这种情况下，该位置是两个视图的边界；a- 要呈现的已分配区域- 返回：
- 返回给定位置的边界框
- 抛出：
BadLocationException- 如果给定位置不是相关文档中的有效位置IllegalArgumentException- 如果为无效的偏移量参数- 另请参见：
View.viewToModel(float, float, 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 坐标，该坐标 >= 0y- 要转换的视图位置的 y 坐标，该坐标 >= 0a- 要呈现的已分配区域bias- 可以是Position.Bias.Forward或Position.Bias.Backward- 返回：
- 模型中最能代表视图中给定点的位置，该位置 >= 0
- 另请参见：
View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])
getNextVisualPositionFrom
public int getNextVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
throws BadLocationException
- 提供一种方法来确定下一个以可视化形式表示的模型位置，用户可以在此位置放置一个插入符。有些视图可能不可见，它们可能与该模型中发现的顺序不同，或它们可能只是不允许访问该模型中的某些位置。这是一个适用于
getNextNorthSouthVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])和getNextEastWestVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])的便捷方法。- 覆盖：
- 类
View中的getNextVisualPositionFrom
- 参数：
pos- 要转换的位置，该位置 >= 0b- 偏移量值，可以是Position.Bias.Forward或Position.Bias.Backwarda- 要呈现的已分配区域direction- 相对当前位置的方向，通常可视为键盘上看到的方向键；它可能为下列值之一：SwingConstants.WESTSwingConstants.EASTSwingConstants.NORTHSwingConstants.SOUTH
biasRet- 一个包含已检查偏移量的数组- 返回：
- 模型中最能代表下一个可视位置的位置
- 抛出：
BadLocationExceptionIllegalArgumentException- 如果direction无效
getViewIndex
public int getViewIndex(int pos,
Position.Bias b)
- 返回表示模型中给定位置的子视图索引。实现此方法可调用
getViewIndexByPosition方法以便向后兼容。- 覆盖：
- 类
View中的getViewIndex
- 参数：
pos- 位置，该位置 >= 0- 返回：
- 表示给定位置的视图的索引，如果没有视图表示该位置，则返回 -1
isBefore
protected abstract boolean isBefore(int x,
int y,
Rectangle alloc)
- 测试一个点是否位于矩形范围之前。
- 参数：
x- X 坐标，该坐标 >= 0y- Y 坐标，该坐标 >= 0alloc- 矩形- 返回：
- 如果该点位于指定范围之前，则返回 true
isAfter
protected abstract boolean isAfter(int x,
int y,
Rectangle alloc)
- 测试一个点是否位于矩形范围之后。
- 参数：
x- X 坐标，该坐标 >= 0y- Y 坐标，该坐标 >= 0alloc- 矩形- 返回：
- 如果该点位于指定范围之后，则返回 true
getViewAtPoint
protected abstract View getViewAtPoint(int x, int y, Rectangle alloc)
- 获取位于给定坐标的子视图。
- 参数：
x- X 坐标，该坐标 >= 0y- Y 坐标，该坐标 >= 0alloc- 入口处父级的分配区域，出口处应改为子级的分配区域- 返回：
- 子视图
childAllocation
protected abstract void childAllocation(int index,
Rectangle a)
- 返回给定子级的分配区域。
- 参数：
index- 子级的索引，该索引 >= 0 且 < getViewCount()a- 入口处框内部的分配区域，和出口索引处的子视图分配区域。
getViewAtPosition
protected View getViewAtPosition(int pos, Rectangle a)
- 获取表示模型中给定位置的子视图。实现此方法，以便在每个子元素都有一个子视图的情况下获取视图。
- 参数：
pos- 位置，该位置 >= 0a- 入口处框内部的分配区域，出口处包含此位置的视图分配区域- 返回：
- 表示给定位置的视图，如果没有视图，则为
null
getViewIndexAtPosition
protected int getViewIndexAtPosition(int pos)
- 获取表示模型中给定位置的子视图索引。实现此方法，以便在每个子元素都有一个子视图的情况下获取视图。
- 参数：
pos- 位置，该位置 >= 0- 返回：
- 表示给定位置的视图的索引，如果没有视图表示该位置，则返回 -1
getInsideAllocation
protected Rectangle getInsideAllocation(Shape a)
- 将分配给视图的不可变分配区域转换为表示内部分配区域的可变分配区域（即给定分配区域的边界，其顶部、左部、底部和右部的 insets 已移除）。返回值需要进一步改变以表示子视图的分配区域。实现此方法可重用一个实例变量，这样可避免创建太多的矩形。通常调用此方法的结果将传给
childAllocation方法。- 参数：
a- 分配给视图的分配区域- 返回：
- 表示视图边界空白全部移除后的内部分配区域；如果给定分配区域为
null，则返回值为null
setParagraphInsets
protected void setParagraphInsets(AttributeSet attr)
- 按照给定属性中指定的段落属性设置 insets。
- 参数：
attr- 属性
setInsets
protected void setInsets(short top,
short left,
short bottom,
short right)
- 设置视图的 insets。
- 参数：
top- 顶部 inset，该值 >= 0left- 左部 inset，该值 >= 0bottom- 底部 inset，该值 >= 0right- 右部 inset，该值 >= 0
getLeftInset
protected short getLeftInset()
- 获取左部 inset。
- 返回：
- inset，该值 >= 0
getRightInset
protected short getRightInset()
- 获取右部 inset。
- 返回：
- inset，该值 >= 0
getTopInset
protected short getTopInset()
- 获取顶部 inset。
- 返回：
- inset，该值 >= 0
getBottomInset
protected short getBottomInset()
- 获取底部 inset。
- 返回：
- inset，该值 >= 0
getNextNorthSouthVisualPositionFrom
protected int getNextNorthSouthVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
throws BadLocationException
- 返回光标的下一个可视位置，可以在北也可以在南。
- 参数：
pos- 要转换的位置，该位置 >= 0b- 偏移量值，可以是Position.Bias.Forward或Position.Bias.Backwarda- 要呈现的已分配区域direction- 相对当前位置的方向，通常可视为键盘上看到的方向键；它可能为下列值之一：SwingConstants.NORTHSwingConstants.SOUTH
biasRet- 一个包含已检查偏移量的数组- 返回：
- 模型中最能代表下一个向北或向南的位置
- 抛出：
BadLocationExceptionIllegalArgumentException- 如果direction无效- 另请参见：
getNextVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])
getNextEastWestVisualPositionFrom
protected int getNextEastWestVisualPositionFrom(int pos,
Position.Bias b,
Shape a,
int direction,
Position.Bias[] biasRet)
throws BadLocationException
- 返回光标的下一个可视位置，可以在东或在西。
- 参数：
pos- 要转换的位置，该位置 >= 0b- 偏移量值，可以是Position.Bias.Forward或Position.Bias.Backwarda- 要呈现的已分配区域direction- 相对当前位置的方向，通常可视为键盘上看到的方向键；它可能为下列值之一：SwingConstants.WESTSwingConstants.EAST
biasRet- 一个包含已检查偏移量的数组- 返回：
- 模型中最能代表下一个向西或向东的位置
- 抛出：
BadLocationExceptionIllegalArgumentException- 如果direction无效- 另请参见：
getNextVisualPositionFrom(int, javax.swing.text.Position.Bias, java.awt.Shape, int, javax.swing.text.Position.Bias[])
flipEastAndWestAtEnds
protected boolean flipEastAndWestAtEnds(int position,
Position.Bias bias)
- 确定下一个视图放置的朝向。假定
View位于索引 n 处，通常View是从左向右放置的，所以在东面的View将位于索引 n + 1 处，在西面的View将位于索引 n - 1 处。在某些情况下（例如双向文本中）有可能东面的View不是位于 n + 1 处，而是位于 n - 1 处，或者西面的View不是位于 n - 1 处，而是位于索引 n + 1 处。这种情况下，该方法将返回 true，指示View按降序放置。它无条件返回 false，如果有可能需要按降序放置
View，则子类应重写此方法。- 参数：
position- 模型中的位置bias- 可以是Position.Bias.Forward或Position.Bias.Backward- 返回：
- false
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。