CompositeView (Java Platform SE 8 )

java.lang.Object
- javax.swing.text.View
- - javax.swing.text.CompositeView

All Implemented Interfaces:

SwingConstants

已知直接子类：

BoxView
```
public abstract class CompositeView
extends View
```
CompositeView是一个抽象的 View实施管理一个或多个子视图。（注意， CompositeView用于管理孩子的观点。相对较少） CompositeView拟作为 View实现的一个起点，如 BoxView，将包含孩子 Views。子类，希望管理儿童 Views收集应使用 replace(int, int, javax.swing.text.View[])方法。作为 View调用 replace DocumentListener通知时，你通常不需要直接调用 replace。
而CompositeView没有对其孩子Views处以布局策略，它允许嵌入孩子Views将包含。插图可以设置通过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将调用childAllocation偏移范围后的CompositeView的Insets。

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
`CompositeView(Element elem)` 构建了一个给定的元素 `CompositeView`。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`protected abstract void`	`childAllocation(int index, Rectangle a)` 返回给定子的分配。
`protected boolean`	`flipEastAndWestAtEnds(int position, Position.Bias bias)` 确定下一个视图的方向。
`protected short`	`getBottomInset()` 得到的底部插入。
`Shape`	`getChildAllocation(int index, Shape a)` 获取给定的子视图渲染成分配。
`protected Rectangle`	`getInsideAllocation(Shape a)` 翻译给视图一个可变分配代表的内部分配不分配（即
`protected short`	`getLeftInset()` 得到了左上角。
`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()` 获取正确的插图。
`protected short`	`getTopInset()` 获取上面镶。
`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)` 设置视图的插图。
`protected void`	`setParagraphInsets(AttributeSet attr)` 集从款镶在给定的属性指定属性。
`void`	`setParent(View parent)` 设置视图的父视图。
`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, getAlignment, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getParent, getPreferredSpan, getResizeWeight, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, paint, preferenceChanged, remove, removeAll, removeUpdate, setSize, updateChildren, updateLayout, viewToModel

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - 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方法不会被调用。
    
    重写：
    
    setParent 方法重写，继承类 View
    
    参数
    
    parent -视图的父，如果没有 null
  - getViewCount
```
public int getViewCount()
```
    返回此视图的子视图的数量。
    
    重写：
    
    getViewCount 方法重写，继承类 View
    
    结果
    
    意见数> = 0
    
    另请参见：
    
    getView(int)
  - getView
```
public View getView(int n)
```
    返回此容器中的第n个视图。
    
    重写：
    
    getView 方法重写，继承类 View
    
    参数
    
    n -所需的数量来看，>＝0和＜getviewcount()
    
    结果
    
    在指数 n观
  - replace
```
public void replace(int offset,
                    int length,
                    View[] views)
```
    替换子视图。如果没有删除此行为的视图作为插入。如果没有添加视图，则作为一个删除。视图被删除会有家长将 null，且他们的内部参考中删除，他们可能被垃圾收集。
    
    重写：
    
    replace 方法重写，继承类 View
    
    参数
    
    offset的起始索引到子视图插入新的观点；> = 0 < = getviewcount
    
    length -删除现有的子视图的数量；这应该是一个价值> = 0 < =（getviewcount()偏移）
    
    views -子视图添加；这个值可以 null表示没有孩子被添加（有用的去除）
  - getChildAllocation
```
public Shape getChildAllocation(int index,
                                Shape a)
```
    获取给定的子视图渲染成分配。这使找出各种视图的位置。
    
    重写：
    
    getChildAllocation 方法重写，继承类 View
    
    参数
    
    index -孩子的指数，>＝0和＜getviewcount()
    
    a -配置这一观点
    
    结果
    
    分配给孩子
  - modelToView
```
public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException
```
    提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
    
    Specified by:
    
    modelToView 方法重写，继承类 View
    
    参数
    
    pos -位置转换> = 0
    
    a -分配区域进行渲染
    
    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
```
    提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
    
    重写：
    
    modelToView 方法重写，继承类 View
    
    参数
    
    p0 -位置转换> = 0
    
    b0 -偏向前一个字符或下一个字符表示的P0，如果位置是两视图边界；要么 Position.Bias.Forward或 Position.Bias.Backward
    
    p1 -位置转换> = 0
    
    b1 -偏向前一个字符或下一个字符表示的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)
```
    从视图坐标空间提供一个映射到模型的逻辑坐标空间。
    
    Specified by:
    
    viewToModel 方法重写，继承类 View
    
    参数
    
    x -视图位置的x坐标转换> = 0
    
    y - y的角度位置坐标转换> = 0
    
    a -分配区域进行渲染
    
    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[])便利的方法。此方法使指定在> = 0的范围内转换的位置。如果值为- 1，则将自动计算一个位置。如果该值小于1，将抛出的 BadLocationException。
    重写：
    
    getNextVisualPositionFrom 方法重写，继承类 View
    
    参数
    
    pos的位置转换
    
    b -一个 Position.Bias.Forward或 Position.Bias.Backward偏置值
    
    a -分配区域进行渲染
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向；这可能是下列之一：
    
    SwingConstants.WEST
    
    SwingConstants.EAST
    
    SwingConstants.NORTH
    
    SwingConstants.SOUTH
    biasRet -一个数组包含的偏差检查
    
    结果
    
    最能代表下一个位置视觉位置的模型中的位置
    
    异常
    
    BadLocationException -给定的位置不在有效的文档位置
    
    IllegalArgumentException -如果 direction无效
  - getViewIndex
```
public int getViewIndex(int pos,
                        Position.Bias b)
```
    返回表示模型中给定位置的子视图索引。这是实现向后兼容性 getViewIndexByPosition方法调用。
    
    重写：
    
    getViewIndex 方法重写，继承类 View
    
    参数
    
    pos --位置> = 0
    
    结果
    
    表示给定位置的视图的索引，或-如果没有视图表示该位置，或- 1
    
    从以下版本开始：
    
    一点三
  - isBefore
```
protected abstract boolean isBefore(int x,
                                    int y,
                                    Rectangle alloc)
```
    测试一个点是否位于矩形范围之前。
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    alloc -矩形
    
    结果
    
    如果该点在指定范围之前是真的
  - isAfter
```
protected abstract boolean isAfter(int x,
                                   int y,
                                   Rectangle alloc)
```
    测试一个点是否在矩形范围后。
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    alloc -矩形
    
    结果
    
    如果该点是在指定的范围后
  - getViewAtPoint
```
protected abstract View getViewAtPoint(int x,
                                       int y,
                                       Rectangle alloc)
```
    把孩子的观点在给定的坐标。
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    alloc -进入父母的分配，应改为孩子的分配退出
    
    结果
    
    孩子的观点
  - childAllocation
```
protected abstract void childAllocation(int index,
                                        Rectangle a)
```
    返回给定子的分配。
    
    参数
    
    index -孩子的指数，>＝0和＜getviewcount()
    
    a -配置在进入盒内，以及分配的子视图在退出指数。
  - getViewAtPosition
```
protected View getViewAtPosition(int pos,
                                 Rectangle a)
```
    把孩子的观点，代表模型中的位置。这是实现在有每个子元素的子视图的情况下获取视图的情况下。
    
    参数
    
    pos --位置> = 0
    
    a -配置在进入盒内，以及分配视图包含出口位置
    
    结果
    
    视图表示在给定的位置，或 null如果没有
  - getViewIndexAtPosition
```
protected int getViewIndexAtPosition(int pos)
```
    把孩子的观点代表了指数模型中的位置。这是实现在有每个子元素的子视图的情况下获取视图的情况下。
    
    参数
    
    pos --位置> = 0
    
    结果
    
    表示给定位置的视图的索引，或-如果没有视图表示该位置，或- 1
  - getInsideAllocation
```
protected Rectangle getInsideAllocation(Shape a)
```
    翻译给视图一个可变分配代表的内部分配不分配（即边界给定配置的顶部，底部，左，右插入删除。预计返回值将进一步突变，以表示对子视图的分配。这是实现重用一个实例变量，所以它避免了创建过多的矩形。通常，调用此方法的结果将是美联储的 childAllocation方法。
    
    参数
    
    a -给视图的配置
    
    结果
    
    代表查看里面的利润都被删除后的分配；如果给定的配置 null，返回值是 null
  - setParagraphInsets
```
protected void setParagraphInsets(AttributeSet attr)
```
    集从款镶在给定的属性指定属性。
    
    参数
    
    attr -属性
  - setInsets
```
protected void setInsets(short top,
                         short left,
                         short bottom,
                         short right)
```
    设置视图的插图。
    
    参数
    
    top -顶部插入> = 0
    
    left -左上角> = 0
    
    bottom -底部插入> = 0
    
    right -正确的插入> = 0
  - getLeftInset
```
protected short getLeftInset()
```
    得到了左上角。
    
    结果
    
    插入> = 0
  - getRightInset
```
protected short getRightInset()
```
    获取正确的插图。
    
    结果
    
    插入> = 0
  - getTopInset
```
protected short getTopInset()
```
    获取上面镶。
    
    结果
    
    插入> = 0
  - getBottomInset
```
protected short getBottomInset()
```
    得到的底部插入。
    
    结果
    
    插入> = 0
  - getNextNorthSouthVisualPositionFrom
```
protected int getNextNorthSouthVisualPositionFrom(int pos,
                                                  Position.Bias b,
                                                  Shape a,
                                                  int direction,
                                                  Position.Bias[] biasRet)
                                           throws BadLocationException
```
    返回光标的下一个视觉位置，无论是在北部或南方向。
    参数
    
    pos -位置转换> = 0
    
    b -一个 Position.Bias.Forward或 Position.Bias.Backward偏置值
    
    a -分配区域进行渲染
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向；这可能是下列之一：
    
    SwingConstants.NORTH
    
    SwingConstants.SOUTH
    biasRet -一个数组包含的偏差检查
    
    结果
    
    最能代表下一个北或南位置的模型中的位置
    
    异常
    
    BadLocationException
    
    IllegalArgumentException -如果 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 -位置转换> = 0
    
    b -一个 Position.Bias.Forward或 Position.Bias.Backward偏置值
    
    a -分配区域进行渲染
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向；这可能是下列之一：
    
    SwingConstants.WEST
    
    SwingConstants.EAST
    biasRet -一个数组包含的偏差检查
    
    结果
    
    最能代表下一个西部或东部位置的模型的位置
    
    异常
    
    BadLocationException
    
    IllegalArgumentException -如果 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)
```
    确定下一个视图的方向。在索引通常 Views布局从左到右考虑 View，使 View向东将在指数n + 1，和 View向西将指数n - 1。在某些情况下，如双向文本，它是可能的， View东不在指数n + 1，而是在指数n - 1，或者说， View向西是不是指数n - 1，但指数n + 1。在这种情况下，此方法将返回true，表示 Views布局排列。
    这无条件返回false，子类应重写此方法，如果有Views依次铺设的可能性。
    
    参数
    
    position位置到模型
    
    bias - Position.Bias.Forward或 Position.Bias.Backward
    
    结果
    
    假

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class CompositeView

Field Summary

Fields inherited from class javax.swing.text.View

Fields inherited from interface javax.swing.SwingConstants

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.View

Methods inherited from class java.lang.Object

Constructor Detail

CompositeView

方法详细信息

loadChildren

setParent

getViewCount

getView

replace

getChildAllocation

modelToView

modelToView

viewToModel

getNextVisualPositionFrom

getViewIndex

isBefore

isAfter

getViewAtPoint

childAllocation

getViewAtPosition

getViewIndexAtPosition

getInsideAllocation

setParagraphInsets

setInsets

getLeftInset

getRightInset

getTopInset

getBottomInset

getNextNorthSouthVisualPositionFrom

getNextEastWestVisualPositionFrom

flipEastAndWestAtEnds