javax.swing.text
类 TableView

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

所有已实现的接口：

SwingConstants

public abstract class TableView
extends BoxView

为某个表实现 View 接口，这由一个元素结构组成，其中此视图负责的元素的子元素表示行，而行元素的子元素为单元格。在单元格元素下可以有任意的元素结构，这将由通过 getViewFactory 方法返回的 ViewFactory 来构建。

    表
      行
        单元格
        单元格
      行
        单元格
        单元格

 

此类实现为一个框的层次，表本身是垂直框，行是水平框，单元格是垂直框。单元格允许跨越多个列和行。在默认情况下，表可认为是在网格之上形成的（即可以在网格包布局中找到类似物），其中表单元格能请求跨越多个网格单元格。默认情况下，表单元格的水平跨距以此网格为基础，但是可以通过重新实现所请求的单元格跨距来更改（即需要时表单元格可以具有独立的跨距）。

另请参见：

View

TableView

public TableView(Element elem)

针对给定的元素构造一个 TableView。

参数：

elem - 此视图所负责的元素

createTableRow

protected TableView.TableRow createTableRow(Element elem)

创建新的表格行。

参数：

elem - 元素

返回：

行

createTableCell

@Deprecated
protected TableView.TableCell createTableCell(Element elem)

已过时。 现在表单元格可以是任意视图实现并且应该由 ViewFactory 而不是表来产生。

参数：

elem - 元素

返回：

单元格

forwardUpdate

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

从类 BoxView 复制的描述

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

覆盖：

类 BoxView 中的 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)

replace

public void replace(int offset,
                    int length,
                    View[] views)

更改子视图。实现此方法来提供超类的行为并且使网格无效，以便对行和列进行重新计算。

覆盖：

类 BoxView 中的 replace

参数：

offset - 要插入新视图的子视图的开始索引；其值 >= 0 且 <= getViewCount

length - 要移除的现有子视图数；其值 >= 0 且 <= (getViewCount() - offset)

views - 要添加的子视图；此值可以为 null，表示没有要添加的子级（对移除有用）

layoutColumns

protected void layoutColumns(int targetSpan,
                             int[] offsets,
                             int[] spans,
                             SizeRequirements[] reqs)

布局列，使其符合给定的目标跨距。通过 offsets 和 spans 返回结果。

参数：

targetSpan - 所有表格列总的给定跨距

reqs - 每一列的所需大小。此参数是请求最小、首选、最大跨距的单元的列最大值

spans - 分配给每一列的量的返回值

offsets - 距每一列起始点的偏移量的返回值

layoutMinorAxis

protected void layoutMinorAxis(int targetSpan,
                               int axis,
                               int[] offsets,
                               int[] spans)

针对框的辅轴（即垂直于其所表示的轴的轴）执行布局操作。布局的结果应当置于给定数组中，该数组对子级沿辅轴的位置分配。只要布局需要沿辅轴进行更新，超类便调用此方法。

实现此方法来调用 layoutColumns 方法，然后转发给超类来实际执行表格行的布局。

覆盖：

类 BoxView 中的 layoutMinorAxis

参数：

targetSpan - 给视图的总跨距，将用于对子级的布局。

axis - 要布局的轴。

offsets - 距每个子视图的视图起始处的偏移量。这是一个返回值，由此方法的实现填写。

spans - 每个子视图的跨距。这是一个返回值，由此方法的实现填写。

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis,
                                                          SizeRequirements r)

计算辅轴的所需大小。只要所需大小需要更新（即一个 preferenceChanged 传给了此视图），超类便调用此方法。

实现此方法来计算作为列的所需大小之和的所需大小。

覆盖：

类 BoxView 中的 calculateMinorAxisRequirements

参数：

axis - 所考察的轴

r - SizeRequirements 对象；如果为 null，将创建一个对象

返回：

新初始化的 SizeRequirements 对象

另请参见：

SizeRequirements

getViewAtPosition

protected View getViewAtPosition(int pos,
                                 Rectangle a)

获取表示模型中给定位置的子视图。实现此方法以通过遍历子级来查找包含给定位置的范围。在此视图中，子级与子元素无须具有一一对应的映射。

覆盖：

类 CompositeView 中的 getViewAtPosition

参数：

pos - 查找位置，该值 >= 0

a - 入口处表的分配和出口处包含该位置的视图的分配

返回：

表示给定位置的视图，如果不存在则返回 null

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。