Java javax.swing.text 类 BoxView（JDK5）

200 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing.text
类 BoxView

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

所有已实现的接口：: SwingConstants

直接已知子类：: BlockView, FlowView, TableView, TableView.TableCell, TableView.TableRow, WrappedPlainView, ZoneView

public class BoxView
extends CompositeView
extends CompositeView

一个视图，它通过沿某轴平铺将其子级排列到框形状中。此框与 TeX 中的框有些类似，它需要处理子级的对齐方式，还要考虑到子级的灵活性等等。这是一个构造块，可用于表示类似线、段落、列表、列、页面等的集合。子级平铺时沿用的轴被视为主轴。与它垂直的轴为辅轴。

每个轴的布局分别由 layoutMajorAxis 和 layoutMinorAxis 方法单独处理。子类可通过重新实现这些方法来更改该布局算法。需要时将根据是否有缓存布局信息以及此缓存是否有效来调用这些方法。通常情况下，当沿轴的给定大小发生更改，或者调用了 layoutChanged 对布局强制更新时，此方法被调用。layoutChanged 方法使缓存布局信息无效（如果有）。发布到父视图的要求是通过 calculateMajorAxisRequirements 和 calculateMinorAxisRequirements 进行计算的。如果布局算法已更改，这些方法按道理都需要重新实现。

字段摘要

从类 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`

构造方法摘要
`BoxView(Element elem, int axis)` 构造一个 `BoxView`。

方法摘要
`protected void`	`baselineLayout(int targetSpan, int axis, int[] offsets, int[] spans)` 在给定的 `targetSpan` 区域，即我们将使用的区域的宽度（或高度），计算每个子视图在此 `BoxView` 中的位置和扩展。
`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)` 提供从视图坐标空间到模型逻辑坐标空间的映射。

从类 javax.swing.text.CompositeView 继承的方法
`getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, loadChildren, modelToView, setInsets, setParagraphInsets, setParent`

从类 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`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

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
从以下版本开始：: 1.3

setAxis

public void setAxis(int axis)

设置平铺轴属性。这是子视图平铺沿用的轴。

参数：: axis - View.X_AXIS 或 View.Y_AXIS 之一
从以下版本开始：: 1.3

layoutChanged

public void layoutChanged(int axis)

使沿某轴的布局变得无效。如果任何一个子视图的首选项发生更改，将自动使所沿轴的布局变得无效。有些情况下，如果首选项未更改，则可能需要重新计算布局。调用此方法可将布局标记为无效。下次在此视图（通常在绘制中）上调用 setSize 方法时，布局将被更新。

参数：: axis - View.X_AXIS 或 View.Y_AXIS 之一
从以下版本开始：: 1.3

isLayoutValid

protected boolean isLayoutValid(int axis)

确定沿给定轴的布局是否有效。

参数：: axis - View.X_AXIS 或 View.Y_AXIS 之一
从以下版本开始：: 1.4

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 的偏移量和区域。

覆盖：: 类 CompositeView 中的 replace

参数：: index - 要插入新视图的子视图的开始索引；其值 >= 0 且 <= getViewCount; length - 要移除的现有子视图数；其值 >= 0 且 <= (getViewCount() - offset); elems - 要添加的子视图；此值可以为 null，表示没有要添加的子级（对移除有用）

forwardUpdate

protected void forwardUpdate(DocumentEvent.ElementChange ec,
                             DocumentEvent e,
                             Shape a,
                             ViewFactory f)

将给定的 DocumentEvent 转发给需要接收模型更改通知的子视图。如果有一个子级更改了它的要求并且在转发前分配为有效，则框中从开始子级到框结束部分将重新被绘制。

覆盖：: 类 View 中的 forwardUpdate

参数：: 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)