BoxView (Java Platform SE 8 )

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

All Implemented Interfaces:

SwingConstants

已知直接子类：

BlockView， FlowView， TableView， TableView.TableCell， TableView.TableRow， WrappedPlainView， ZoneView
```
public class BoxView
extends CompositeView
```
一种观点认为，安排孩子成盒状平铺的孩子沿着轴线。盒子有点像在TeX，那里的孩子比对发现，是孩子们的灵活性，等等这是一个构建块，可能代表的东西像一个收集线，有用的段落、列表、栏目、页面、等轴沿这孩子是瓷砖被认为是主要的轴。正交轴是次要的轴。
每个轴布局的方法layoutMajorAxis和layoutMinorAxis分别办理。子类可以重新实现这些方法改变布局算法。这些方法将被称为必要的，取决于是否有缓存的布局信息和缓存被认为是有效的。这些方法通常被称为如果给定的轴向尺寸变化，或者如果layoutChanged称为强制更新的布局。layoutChanged方法无效的缓存布局信息，如果有任何。要求发布到父视图的方法calculateMajorAxisRequirements和calculateMinorAxisRequirements计算。如果布局算法的改变，这些方法可能会需要重新实现。

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
`BoxView(Element elem, int axis)` 构建了一个 `BoxView`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`protected void`	`baselineLayout(int targetSpan, int axis, int[] offsets, int[] spans)` 计算位置和每个子视图的程度在这 `BoxView`给予 `targetSpan`，它的宽度（或高度）的地区，我们的工作。
`protected SizeRequirements`	`baselineRequirements(int axis, SizeRequirements r)` 计算这 `BoxView`尺寸要求通过检查每个子视图的大小。
`protected SizeRequirements`	`calculateMajorAxisRequirements(int axis, SizeRequirements r)` 计算主轴 `axis`尺寸要求。
`protected SizeRequirements`	`calculateMinorAxisRequirements(int axis, SizeRequirements r)` 计算短轴 `axis`尺寸要求。
`protected void`	`childAllocation(int index, Rectangle alloc)` 分配子视图的区域。
`protected boolean`	`flipEastAndWestAtEnds(int position, Position.Bias bias)` 确定下一个视图的方向。
`protected void`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)` 提出了 `DocumentEvent`，需要通知的变化对模型的子视图。
`float`	`getAlignment(int axis)` 沿着一个轴确定此视图所需的对齐方式。
`int`	`getAxis()` 取瓦轴属性。
`Shape`	`getChildAllocation(int index, Shape a)` 获取给定的子视图的配置。
`int`	`getHeight()` 返回框的当前高度。
`float`	`getMaximumSpan(int axis)` 沿着一个轴确定该视图的最大跨度。
`float`	`getMinimumSpan(int axis)` 沿着一个轴确定该视图的最小间距。
`protected int`	`getOffset(int axis, int childIndex)` 取某个孩子的当前布局中的偏移量。
`float`	`getPreferredSpan(int axis)` 沿着一个轴确定该视图的首选跨度。
`int`	`getResizeWeight(int axis)` 获取调整大小重量。
`protected int`	`getSpan(int axis, int childIndex)` 取一个特定的孩子的当前布局跨度。
`protected View`	`getViewAtPoint(int x, int y, Rectangle alloc)` 把孩子的观点在给定的坐标。
`int`	`getWidth()` 返回框的当前宽度。
`protected boolean`	`isAfter(int x, int y, Rectangle innerAlloc)` 确定一个点是否在分配的区域后下降。
`protected boolean`	`isAllocationValid()` 儿童的分配仍然有效吗？
`protected boolean`	`isBefore(int x, int y, Rectangle innerAlloc)` 确定在分配区域之前是否有一个点。
`protected boolean`	`isLayoutValid(int axis)` 确定布局是否沿着给定的轴有效。
`protected void`	`layout(int width, int height)` 在盒子上执行布局
`void`	`layoutChanged(int axis)` 沿轴线布局无效。
`protected void`	`layoutMajorAxis(int targetSpan, int axis, int[] offsets, int[] spans)` 执行框的主要轴的布局（即
`protected void`	`layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)` 执行框的小轴的布局（即
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)` 提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
`void`	`paint(Graphics g, Shape allocation)` 使 `BoxView`使用给定的表面绘制和面积，表面。
`protected void`	`paintChild(Graphics g, Rectangle alloc, int index)` 画一个孩子。
`void`	`preferenceChanged(View child, boolean width, boolean height)` 这是由一个孩子来表示它的首选跨度改变了。
`void`	`replace(int index, int length, View[] elems)` 无效的布局和大小的请求/分配缓存。
`void`	`setAxis(int axis)` 设置瓷砖轴属性。
`void`	`setSize(float width, float height)` 设置视图的大小。
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] bias)` 从视图坐标空间提供一个映射到模型的逻辑坐标空间。

Methods inherited from class javax.swing.text.CompositeView
getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, loadChildren, modelToView, setInsets, setParagraphInsets, setParent

Methods inherited from class javax.swing.text.View
append, breakView, changedUpdate, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, remove, removeAll, removeUpdate, updateChildren, updateLayout, viewToModel

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

- Constructor Detail
  - BoxView
```
public BoxView(Element elem,
               int axis)
```
    构建了一个 BoxView。
    
    参数
    
    elem -元这一观点负责
    
    axis - View.X_AXIS或 View.Y_AXIS
- 方法详细信息
  - getAxis
```
public int getAxis()
```
    取瓦轴属性。这是子视图的子视图的轴。
    
    结果
    
    盒子的长轴，要么 View.X_AXIS或 View.Y_AXIS
    
    从以下版本开始：
    
    一点三
  - setAxis
```
public void setAxis(int axis)
```
    设置瓷砖轴属性。这是子视图的子视图的轴。
    
    参数
    
    axis - View.X_AXIS或 View.Y_AXIS
    
    从以下版本开始：
    
    一点三
  - layoutChanged
```
public void layoutChanged(int axis)
```
    沿轴线布局无效。如果对任何子视图都发生了更改，这种情况会自动发生。在某些情况下，可能需要重新布局时的偏好并没有改变。通过调用此方法，布局可以标记为无效的。布局将更新下一次 setSize方法称为基于这种观点（通常在油漆）。
    
    参数
    
    axis - View.X_AXIS或 View.Y_AXIS
    
    从以下版本开始：
    
    一点三
  - isLayoutValid
```
protected boolean isLayoutValid(int axis)
```
    确定布局是否沿着给定的轴有效。
    
    参数
    
    axis - View.X_AXIS或 View.Y_AXIS
    
    从以下版本开始：
    
    一点四
  - paintChild
```
protected void paintChild(Graphics g,
                          Rectangle alloc,
                          int index)
```
    画一个孩子。默认情况下，它是所有的，但一个子类可以使用这个来画东西相对于孩子。
    
    参数
    
    g -图形上下文
    
    alloc -分配区域涂成
    
    index -孩子指数> = 0和＜getviewcount()
  - replace
```
public void replace(int index,
                    int length,
                    View[] elems)
```
    无效的布局和大小的请求/分配缓存。该子分配仍然可以访问旧的布局，但新的孩子将有一个偏移和跨度为0。
    
    重写：
    
    replace 方法重写，继承类 CompositeView
    
    参数
    
    index的起始索引到子视图插入新的观点；这应该是一个价值> = 0 < = getviewcount
    
    length -删除现有的子视图的数量；这应该是一个价值> = 0 < =（getviewcount()偏移）
    
    elems -子视图添加；这个值可以 nullto表示没有孩子被添加（有用的去除）
  - forwardUpdate
```
protected void forwardUpdate(DocumentEvent.ElementChange ec,
                             DocumentEvent e,
                             Shape a,
                             ViewFactory f)
```
    提出了 DocumentEvent，需要通知的变化对模型的子视图。如果一个孩子改变了要求和分配是有效的转发框的部分从孩子到盒结束前将油漆。
    
    重写：
    
    forwardUpdate 方法重写，继承类 View
    
    参数
    
    ec -更改元素这一观点负责（可能是 null如果没有变化）
    
    e -从相关文档的变更信息
    
    a -视图的当前配置
    
    f -工厂用重建如果视图有孩子
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)， View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)， View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)
  - preferenceChanged
```
public void preferenceChanged(View child,
                              boolean width,
                              boolean height)
```
    这是由一个孩子来表示它的首选跨度改变了。这是实现丢弃缓存的布局信息，以便新的计算将做下一次的孩子们需要一个分配。
    
    重写：
    
    preferenceChanged 方法重写，继承类 View
    
    参数
    
    child -子视图
    
    width -如果宽度优先应该改变
    
    height -如果身高偏好应该改变
    
    另请参见：
    
    JComponent.revalidate()
  - getResizeWeight
```
public int getResizeWeight(int axis)
```
    获取调整大小重量。值为0或更少的不可调整大小。
    
    重写：
    
    getResizeWeight 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    重量
    
    异常
    
    IllegalArgumentException -无效的轴
  - setSize
```
public void setSize(float width,
                    float height)
```
    设置视图的大小。如果视图缓存任何布局信息，这将导致视图的布局。这是实现调用布局方法与insets的内部尺寸。
    
    重写：
    
    setSize 方法重写，继承类 View
    
    参数
    
    width -宽度> = 0
    
    height -高> = 0
  - paint
```
public void paint(Graphics g,
                  Shape allocation)
```
    使 BoxView使用给定的表面绘制和面积，表面。只有孩子的 Graphics相交将剪辑的界限。
    
    Specified by:
    
    paint 方法重写，继承类 View
    
    参数
    
    g -绘制表面使用
    
    allocation -分配区域进行渲染
    
    另请参见：
    
    View.paint(java.awt.Graphics, java.awt.Shape)
  - getChildAllocation
```
public Shape getChildAllocation(int index,
                                Shape a)
```
    获取给定的子视图的配置。这使找出各种视图的位置。这是实施，如果布局是无效的返回 null，否则执行父类的行为。
    
    重写：
    
    getChildAllocation 方法重写，继承类 CompositeView
    
    参数
    
    index -孩子的指数，>＝0和> getviewcount()
    
    a -配置这一观点
    
    结果
    
    分配给孩子；或 null如果 a是 null；或 null如果布局是无效的
  - modelToView
```
public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException
```
    提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。这可以确保分配是有效的调用父类之前。
    
    重写：
    
    modelToView 方法重写，继承类 CompositeView
    
    参数
    
    pos -位置转换> = 0
    
    a -分配区域进行渲染
    
    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)
```
    从视图坐标空间提供一个映射到模型的逻辑坐标空间。
    
    重写：
    
    viewToModel 方法重写，继承类 CompositeView
    
    参数
    
    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[])
  - getAlignment
```
public float getAlignment(int axis)
```
    沿着一个轴确定此视图所需的对齐方式。实现这一点，给所需的总对准位置的孩子们排队沿轴线垂直于被瓷砖的轴线对齐的对齐点。轴的瓷砖要集中（即通道）。
    
    重写：
    
    getAlignment 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    需要对齐> = 0.0f & < = 1.0f；这应该是一个介于0和1，0表示对齐值在原点和1表示对齐全跨远离原点；0.5对齐将视图的中心
    
    异常
    
    IllegalArgumentException -无效的轴
  - getPreferredSpan
```
public float getPreferredSpan(int axis)
```
    沿着一个轴确定该视图的首选跨度。
    
    Specified by:
    
    getPreferredSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    跨度的视图将被渲染成= 0；通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证，父可能会选择调整或打破视图
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getMinimumSpan
```
public float getMinimumSpan(int axis)
```
    沿着一个轴确定该视图的最小间距。
    
    重写：
    
    getMinimumSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    跨度的视图将被渲染成= 0；通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证，父可能会选择调整或打破视图
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getMaximumSpan
```
public float getMaximumSpan(int axis)
```
    沿着一个轴确定该视图的最大跨度。
    
    重写：
    
    getMaximumSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    跨度的视图将被渲染成= 0；通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证，父可能会选择调整或打破视图
    
    异常
    
    IllegalArgumentException -无效的轴型
    
    另请参见：
    
    View.getPreferredSpan(int)
  - isAllocationValid
```
protected boolean isAllocationValid()
```
    儿童的分配仍然有效吗？
    
    结果
    
    如果分配仍然有效
  - isBefore
```
protected boolean isBefore(int x,
                           int y,
                           Rectangle innerAlloc)
```
    确定在分配区域之前是否有一个点。
    
    Specified by:
    
    isBefore 方法重写，继承类 CompositeView
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    innerAlloc -分配的区域；这个区域里面的插图
    
    结果
    
    如果该点位于该地区的其他虚假之前
  - isAfter
```
protected boolean isAfter(int x,
                          int y,
                          Rectangle innerAlloc)
```
    确定一个点是否在分配的区域后下降。
    
    Specified by:
    
    isAfter 方法重写，继承类 CompositeView
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    innerAlloc -分配的区域；这个区域里面的插图
    
    结果
    
    如果点在该地区的虚假的谎言之后
  - getViewAtPoint
```
protected View getViewAtPoint(int x,
                              int y,
                              Rectangle alloc)
```
    把孩子的观点在给定的坐标。
    
    Specified by:
    
    getViewAtPoint 方法重写，继承类 CompositeView
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    alloc -父母内配置的入门，应改为孩子的分配退出
    
    结果
    
    观
  - childAllocation
```
protected void childAllocation(int index,
                               Rectangle alloc)
```
    分配子视图的区域。
    
    Specified by:
    
    childAllocation 方法重写，继承类 CompositeView
    
    参数
    
    index -子视图分配指标，>＝0和＜getviewcount()
    
    alloc -分配区域
  - layout
```
protected void layout(int width,
                      int height)
```
    在盒子上执行布局
    
    参数
    
    width -宽度（里面的插图）> = 0
    
    height -高度（里面的插图）> = 0
  - getWidth
```
public int getWidth()
```
    返回框的当前宽度。这是它最后一次分配的宽度。
    
    结果
    
    框的当前宽度
  - getHeight
```
public int getHeight()
```
    返回框的当前高度。这是它最后一次分配的高度。
    
    结果
    
    盒子的当前高度
  - layoutMajorAxis
```
protected void layoutMajorAxis(int targetSpan,
                               int axis,
                               int[] offsets,
                               int[] spans)
```
    执行框的长轴的布局（即它所代表的轴）。布局的结果（每一个孩子的偏移和跨度）被放置在给定的阵列，它代表的分配给儿童沿长轴。
    
    参数
    
    targetSpan -总跨度给视图，可用于布局的孩子
    
    axis -轴布置
    
    offsets为每个子视图从视图原点的偏移量；这是一个返回值，由该方法的实现
    
    spans -每个子视图的跨越；这是一个返回值，由该方法的实现
  - layoutMinorAxis
```
protected void layoutMinorAxis(int targetSpan,
                               int axis,
                               int[] offsets,
                               int[] spans)
```
    执行框的小轴的布局（即它所代表的轴的轴垂直轴）。布局的结果（每一个孩子的偏移和跨度）被放置在给定的数组中，代表的分配给儿童沿小轴。
    
    参数
    
    targetSpan -总跨度给视图，可用于布局的孩子
    
    axis -轴布置
    
    offsets为每个子视图从视图原点的偏移量；这是一个返回值，由该方法的实现
    
    spans -每个子视图的跨越；这是一个返回值，由该方法的实现
  - calculateMajorAxisRequirements
```
protected SizeRequirements calculateMajorAxisRequirements(int axis,
                                                          SizeRequirements r)
```
    计算尺寸要求的长轴 axis。
    
    参数
    
    axis -轴的研究
    
    r - SizeRequirements对象；如果 null将会创建一个
    
    结果
    
    新 SizeRequirements对象初始化
    
    另请参见：
    
    SizeRequirements
  - calculateMinorAxisRequirements
```
protected SizeRequirements calculateMinorAxisRequirements(int axis,
                                                          SizeRequirements r)
```
    计算短轴 axis尺寸要求。
    
    参数
    
    axis -轴的研究
    
    r - SizeRequirements对象；如果 null将会创建一个
    
    结果
    
    新 SizeRequirements对象初始化
    
    另请参见：
    
    SizeRequirements
  - baselineLayout
```
protected void baselineLayout(int targetSpan,
                              int axis,
                              int[] offsets,
                              int[] spans)
```
    计算位置和每个子视图的程度在这 BoxView给予 targetSpan，它的宽度（或高度）的地区，我们的工作。
    
    参数
    
    targetSpan -总跨度给视图，可用于布局的孩子
    
    axis -轴的研究，无论是 View.X_AXIS或 View.Y_AXIS
    
    offsets -空数组填充该方法指定每个子视图的位置
    
    spans -空数组填充该方法指定每个子视图的程度
  - baselineRequirements
```
protected SizeRequirements baselineRequirements(int axis,
                                                SizeRequirements r)
```
    计算这 BoxView尺寸要求通过检查每个子视图的大小。
    
    参数
    
    axis -轴的研究
    
    r - SizeRequirements对象；如果 null将会创建一个
    
    结果
    
    新 SizeRequirements对象初始化
  - getOffset
```
protected int getOffset(int axis,
                        int childIndex)
```
    取某个孩子的当前布局中的偏移量。
    
    参数
    
    axis -轴的研究
    
    childIndex -要求的子指标
    
    结果
    
    指定子的偏移量（位置）
  - getSpan
```
protected int getSpan(int axis,
                      int childIndex)
```
    取一个特定的孩子的当前布局跨度。
    
    参数
    
    axis -轴的研究
    
    childIndex -要求的子指标
    
    结果
    
    指定子的跨度（宽度或高度）
  - flipEastAndWestAtEnds
```
protected boolean flipEastAndWestAtEnds(int position,
                                        Position.Bias bias)
```
    确定下一个视图的方向。在索引通常 Views布局从左到右的考虑，使 View向东将在指数n + 1，和 View向西将指数n - 1。在某些情况下，如双向文本，它是可能的， View东不在指数n + 1，而是在指数n - 1，或者说， View向西是不是指数n - 1，但指数n + 1。在这种情况下，此方法将返回true，表示 Views布局排列。否则，方法将虚假表示 Views布局升序返回。
    如果接收器是奠定其在Y_AXIS Views，这将从调用负责绘制position和bias的View方法返回的值。否则这将返回错误。
    
    重写：
    
    flipEastAndWestAtEnds 方法重写，继承类 CompositeView
    
    参数
    
    position位置到模型
    
    bias - Position.Bias.Forward或 Position.Bias.Backward
    
    结果
    
    如果周围的 View渲染 position和 bias响应 Views布局依次为真；否则为false

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 BoxView

Field Summary

Fields inherited from class javax.swing.text.View

Fields inherited from interface javax.swing.SwingConstants

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.CompositeView

Methods inherited from class javax.swing.text.View

Methods inherited from class java.lang.Object

Constructor Detail

BoxView

方法详细信息

getAxis

setAxis

layoutChanged

isLayoutValid

paintChild

replace

forwardUpdate

preferenceChanged

getResizeWeight

setSize

paint

getChildAllocation

modelToView

viewToModel

getAlignment

getPreferredSpan

getMinimumSpan

getMaximumSpan

isAllocationValid

isBefore

isAfter

getViewAtPoint

childAllocation

layout

getWidth

getHeight

layoutMajorAxis

layoutMinorAxis

calculateMajorAxisRequirements

calculateMinorAxisRequirements

baselineLayout

baselineRequirements

getOffset

getSpan

flipEastAndWestAtEnds