JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.table
类 DefaultTableColumnModel

java.lang.Object
  继承者 javax.swing.table.DefaultTableColumnModel
所有已实现的接口:
PropertyChangeListener, Serializable, EventListener, ListSelectionListener, TableColumnModel

public class DefaultTableColumnModel
extends Object
implements TableColumnModel, PropertyChangeListener, ListSelectionListener, Serializable

JTable 的标准列处理程序。

警告:此类的已序列化对象与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder

另请参见:
JTable

字段摘要
protected  ChangeEvent changeEvent
          更改事件(只需要一个)
protected  int columnMargin
          每列之间的空白宽度
protected  boolean columnSelectionAllowed
          此列模型中允许的列选择
protected  EventListenerList listenerList
          TableColumnModelListener 的列表
protected  ListSelectionModel selectionModel
          跟踪列选择的模型
protected  Vector<TableColumn> tableColumns
          此模型中 TableColumn 对象组成的数组
protected  int totalColumnWidth
          所有列总宽度的本地缓存
 
构造方法摘要
DefaultTableColumnModel()
          创建默认的表列模型。
 
方法摘要
 void addColumn(TableColumn aColumn)
          将 aColumn 追加到 tableColumns 数组的结尾。
 void addColumnModelListener(TableColumnModelListener x)
          添加表列模型事件的侦听器。
protected  ListSelectionModel createSelectionModel()
          创建新的默认列表选择模型。
protected  void fireColumnAdded(TableColumnModelEvent e)
          通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected  void fireColumnMarginChanged()
          通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected  void fireColumnMoved(TableColumnModelEvent e)
          通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected  void fireColumnRemoved(TableColumnModelEvent e)
          通知所有对此事件类型的通知感兴趣的已注册侦听器。
protected  void fireColumnSelectionChanged(ListSelectionEvent e)
          通知所有对此事件类型的通知感兴趣的已注册侦听器。
 TableColumn getColumn(int columnIndex)
          返回 columnIndex 处列的 TableColumn 对象。
 int getColumnCount()
          返回 tableColumns 数组中的列数。
 int getColumnIndex(Object identifier)
          返回 tableColumns 数组中第一列的索引,当使用 equals 进行比较时,该列的标识符等于 identifier
 int getColumnIndexAtX(int x)
          返回位于 x 处列的索引,如果该点处没有列,则返回 -1。
 int getColumnMargin()
          返回 TableColumn 的空白宽度。
 TableColumnModelListener[] getColumnModelListeners()
          返回一个包含在此模型上注册的所有列模型侦听器的数组。
 Enumeration<TableColumn> getColumns()
          返回该模型中所有列的一个 Enumeration
 boolean getColumnSelectionAllowed()
          如果允许列选择,则返回 true,否则返回 false。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          返回当前已在此模型上注册为 FooListener 的所有对象组成的数组。
 int getSelectedColumnCount()
          返回选定的列数。
 int[] getSelectedColumns()
          返回包含选定列的数组。
 ListSelectionModel getSelectionModel()
          返回用来维护列选择状态的 ListSelectionModel
 int getTotalColumnWidth()
          返回所有列的总宽度。
 void moveColumn(int columnIndex, int newIndex)
          将 columnIndex 位置的列和标题移到 newIndex
 void propertyChange(PropertyChangeEvent evt)
          Property Change Listener 更改方法。
protected  void recalcWidthCache()
          重新计算所有列的总宽度。
 void removeColumn(TableColumn column)
          从 tableColumns 数组删除 column
 void removeColumnModelListener(TableColumnModelListener x)
          移除表列模型事件的侦听器。
 void setColumnMargin(int newMargin)
          将列空白设置为 newMargin
 void setColumnSelectionAllowed(boolean flag)
          设置是否允许列选择。
 void setSelectionModel(ListSelectionModel newModel)
          将此 TableColumnModel 的选择模型设置为 newModel,并为来自新选择模型的侦听器通知注册它。
 void valueChanged(ListSelectionEvent e)
          列选择更改时转发 ListSelectionEventsListSelectionListener
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

tableColumns

protected Vector<TableColumn> tableColumns
此模型中 TableColumn 对象组成的数组


selectionModel

protected ListSelectionModel selectionModel
跟踪列选择的模型


columnMargin

protected int columnMargin
每列之间的空白宽度


listenerList

protected EventListenerList listenerList
TableColumnModelListener 的列表


changeEvent

protected transient ChangeEvent changeEvent
更改事件(只需要一个)


columnSelectionAllowed

protected boolean columnSelectionAllowed
此列模型中允许的列选择


totalColumnWidth

protected int totalColumnWidth
所有列总宽度的本地缓存

构造方法详细信息

DefaultTableColumnModel

public DefaultTableColumnModel()
创建默认的表列模型。

方法详细信息

addColumn

public void addColumn(TableColumn aColumn)
aColumn 追加到 tableColumns 数组的结尾。此方法还将 columnAdded 事件发送到它的侦听器。

指定者:
接口 TableColumnModel 中的 addColumn
参数:
aColumn - 要添加的 TableColumn
抛出:
IllegalArgumentException - 如果 aColumnnull
另请参见:
removeColumn(javax.swing.table.TableColumn)

removeColumn

public void removeColumn(TableColumn column)
tableColumns 数组删除 column。如果 column 不在该表各列的列表中,则此方法不执行任何操作。此方法调用 tile 重新调整标题和表视图的大小。此方法还将 columnRemoved 事件发送到它的侦听器。

指定者:
接口 TableColumnModel 中的 removeColumn
参数:
column - 要移除的 TableColumn
另请参见:
addColumn(javax.swing.table.TableColumn)

moveColumn

public void moveColumn(int columnIndex,
                       int newIndex)
columnIndex 位置的列和标题移到 newIndex。原来在 columnIndex 位置的列现在可以在 newIndex 处找到。newIndex 位置上的原有列向左或右移动以留出空间。如果 columnIndex 等于 newIndex,则此操作不移动任何列。此方法还将 columnMoved 事件发送到它的侦听器。

指定者:
接口 TableColumnModel 中的 moveColumn
参数:
columnIndex - 要移动列的索引
newIndex - 将列移动到该新索引位置
抛出:
IllegalArgumentException - 如果 columnnewIndex 不在有效范围内

setColumnMargin

public void setColumnMargin(int newMargin)
将列空白设置为 newMargin。此方法还将 columnMarginChanged 事件发送到它的侦听器。

指定者:
接口 TableColumnModel 中的 setColumnMargin
参数:
newMargin - 新的空白宽度,以像素为单位
另请参见:
getColumnMargin(), getTotalColumnWidth()

getColumnCount

public int getColumnCount()
返回 tableColumns 数组中的列数。

指定者:
接口 TableColumnModel 中的 getColumnCount
返回:
tableColumns 数组中的列数
另请参见:
getColumns()

getColumns

public Enumeration<TableColumn> getColumns()
返回该模型中所有列的一个 Enumeration

指定者:
接口 TableColumnModel 中的 getColumns
返回:
该模型中所有列的一个 Enumeration

getColumnIndex

public int getColumnIndex(Object identifier)
返回 tableColumns 数组中第一列的索引,当使用 equals 进行比较时,该列的标识符等于 identifier

指定者:
接口 TableColumnModel 中的 getColumnIndex
参数:
identifier - 标识符对象
返回:
tableColumns 数组中第一列的索引,该列的标识符等于 identifier
抛出:
IllegalArgumentException - 如果 identifiernull,或者没有 TableColumn 具有此 identifier
另请参见:
getColumn(int)

getColumn

public TableColumn getColumn(int columnIndex)
返回 columnIndex 处列的 TableColumn 对象。

指定者:
接口 TableColumnModel 中的 getColumn
参数:
columnIndex - 所需列的索引
返回:
columnIndex 处列的 TableColumn 对象

getColumnMargin

public int getColumnMargin()
返回 TableColumn 的空白宽度。默认的 columnMargin 为 1。

指定者:
接口 TableColumnModel 中的 getColumnMargin
返回:
TableColumn 的最大宽度
另请参见:
setColumnMargin(int)

getColumnIndexAtX

public int getColumnIndexAtX(int x)
返回位于 x 处列的索引,如果该点处没有列,则返回 -1。 为了与 Swing 的可分离模型架构保持一致,TableColumnModel 不知道表的各列是如何实际显示在屏幕上的。各列的可视化表示由使用此模型的视图/控制器(通常是 JTable)来负责。该视图/控制器无需从左到右按顺序显示各列。例如,为了适应语言环境的优先选择,可以从右到左显示各列,或者可能根据用户的请求隐藏某些列。因为模型不知道各列是如何在屏幕上布局的,所以不应将给定的 xPosition 认为是 2D 图形空间中的坐标。相反,应该将其认为是从模型中首列开始的一个宽度。如果需要 2D 空间中给定 X 坐标的列索引,则可以使用 JTable.columnAtPoint

指定者:
接口 TableColumnModel 中的 getColumnIndexAtX
参数:
x - 需要的水平位置
返回:
列的索引,如果未找到列,则返回 -1
另请参见:
JTable.columnAtPoint(java.awt.Point)

getTotalColumnWidth

public int getTotalColumnWidth()
返回所有列的总宽度。

指定者:
接口 TableColumnModel 中的 getTotalColumnWidth
返回:
totalColumnWidth 属性

setSelectionModel

public void setSelectionModel(ListSelectionModel newModel)
将此 TableColumnModel 的选择模型设置为 newModel,并为来自新选择模型的侦听器通知注册它。如果 newModelnull,则抛出一个异常。

指定者:
接口 TableColumnModel 中的 setSelectionModel
参数:
newModel - 新的选择模型
抛出:
IllegalArgumentException - 如果 newModelnull
另请参见:
getSelectionModel()

getSelectionModel

public ListSelectionModel getSelectionModel()
返回用来维护列选择状态的 ListSelectionModel

指定者:
接口 TableColumnModel 中的 getSelectionModel
返回:
提供列选择状态的对象。如果不允许列选择,则返回 null
另请参见:
setSelectionModel(javax.swing.ListSelectionModel)

setColumnSelectionAllowed

public void setColumnSelectionAllowed(boolean flag)
设置是否允许列选择。默认值为 false。

指定者:
接口 TableColumnModel 中的 setColumnSelectionAllowed
参数:
flag - 如果允许列选择,则为 true,否则为 false
另请参见:
TableColumnModel.getColumnSelectionAllowed()

getColumnSelectionAllowed

public boolean getColumnSelectionAllowed()
如果允许列选择,则返回 true,否则返回 false。默认值为 false。

指定者:
接口 TableColumnModel 中的 getColumnSelectionAllowed
返回:
columnSelectionAllowed 属性
另请参见:
TableColumnModel.setColumnSelectionAllowed(boolean)

getSelectedColumns

public int[] getSelectedColumns()
返回包含选定列的数组。如果 selectionModelnull,则返回一个空数组。

指定者:
接口 TableColumnModel 中的 getSelectedColumns
返回:
包含选定列的数组,如果没有选定的列,或 selectionModelnull,则返回一个空数组

getSelectedColumnCount

public int getSelectedColumnCount()
返回选定的列数。

指定者:
接口 TableColumnModel 中的 getSelectedColumnCount
返回:
选定的列数

addColumnModelListener

public void addColumnModelListener(TableColumnModelListener x)
添加表列模型事件的侦听器。

指定者:
接口 TableColumnModel 中的 addColumnModelListener
参数:
x - 一个 TableColumnModelListener 对象

removeColumnModelListener

public void removeColumnModelListener(TableColumnModelListener x)
移除表列模型事件的侦听器。

指定者:
接口 TableColumnModel 中的 removeColumnModelListener
参数:
x - 一个 TableColumnModelListener 对象

getColumnModelListeners

public TableColumnModelListener[] getColumnModelListeners()
返回一个包含在此模型上注册的所有列模型侦听器的数组。

返回:
此默认表列模型的所有 ColumnModelListener,如果当前没有已注册的列模型侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addColumnModelListener(javax.swing.event.TableColumnModelListener), removeColumnModelListener(javax.swing.event.TableColumnModelListener)

fireColumnAdded

protected void fireColumnAdded(TableColumnModelEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。使用传入此触发方法的参数延后(lazily)创建事件实例。

参数:
e - 接收的事件
另请参见:
EventListenerList

fireColumnRemoved

protected void fireColumnRemoved(TableColumnModelEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。使用传入此触发方法的参数延后创建事件实例。

参数:
e - 接收的事件
另请参见:
EventListenerList

fireColumnMoved

protected void fireColumnMoved(TableColumnModelEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。使用传入此触发方法的参数延后创建事件实例。

参数:
e - 接收的事件
另请参见:
EventListenerList

fireColumnSelectionChanged

protected void fireColumnSelectionChanged(ListSelectionEvent e)
通知所有对此事件类型的通知感兴趣的已注册侦听器。使用传入此触发方法的参数延后创建事件实例。

参数:
e - 接收的事件
另请参见:
EventListenerList

fireColumnMarginChanged

protected void fireColumnMarginChanged()
通知所有对此事件类型的通知感兴趣的已注册侦听器。使用传入此触发方法的参数延后创建事件实例。

另请参见:
EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
返回当前已在此模型上注册为 FooListener 的所有对象组成的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值(如 FooListener.class)来指定 listenerType 参数。例如,可以使用以下代码查询 DefaultTableColumnModel m 的列模型侦听器:

ColumnModelListener[] cmls = (ColumnModelListener[])(m.getListeners(ColumnModelListener.class));
如果不存在这样的侦听器,则此方法将返回一个空数组。

参数:
listenerType - 请求的侦听器类型;此参数应该指定一个从 java.util.EventListener 继承的接口
返回:
在此模型上注册为 FooListener 的所有对象组成的数组,如果没有添加这样的侦听器,则返回一个空数组
抛出:
ClassCastException - 如果 listenerType 未指定实现 java.util.EventListener 的类或接口。
从以下版本开始:
1.3
另请参见:
getColumnModelListeners()

propertyChange

public void propertyChange(PropertyChangeEvent evt)
Property Change Listener 更改方法。用于跟踪列宽或首选列宽的更改。

指定者:
接口 PropertyChangeListener 中的 propertyChange
参数:
evt - PropertyChangeEvent

valueChanged

public void valueChanged(ListSelectionEvent e)
列选择更改时转发 ListSelectionEventsListSelectionListener

指定者:
接口 ListSelectionListener 中的 valueChanged
参数:
e - 更改事件

createSelectionModel

protected ListSelectionModel createSelectionModel()
创建新的默认列表选择模型。


recalcWidthCache

protected void recalcWidthCache()
重新计算所有列的总宽度。更新 totalColumnWidth 属性。


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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