JavaTM 2 Platform
Standard Ed. 6

javax.swing.table
介面 TableColumnModel

所有已知實作類別:
DefaultTableColumnModel

public interface TableColumnModel

定義了適合用於 JTable 的表列模型物件的要求。

另請參見:
DefaultTableColumnModel

方法摘要
 void addColumn(TableColumn aColumn)
          將 aColumn 追加到 tableColumns 陣列的結尾。
 void addColumnModelListener(TableColumnModelListener x)
          為表列模型事件添加偵聽器。
 TableColumn getColumn(int columnIndex)
          返回 columnIndex 位置列的 TableColumn 物件。
 int getColumnCount()
          返回該模型中的列數。
 int getColumnIndex(Object columnIdentifier)
          返回該表中首列的索引,使用 equals 進行比較時,該列的標識符等於 identifier
 int getColumnIndexAtX(int xPosition)
          返回位於該水平點 xPosition 位置列的索引;如果該點位於任何列邊界外,則返回 -1。
 int getColumnMargin()
          返回每列中單元格之間的寬度。
 Enumeration<TableColumn> getColumns()
          返回該模型中所有列的 Enumeration
 boolean getColumnSelectionAllowed()
          如果可以選擇列,則返回 true。
 int getSelectedColumnCount()
          返回選定的列數。
 int[] getSelectedColumns()
          返回所有選定列的索引陣列。
 ListSelectionModel getSelectionModel()
          返回當前的選擇模型。
 int getTotalColumnWidth()
          返回所有列的總寬度。
 void moveColumn(int columnIndex, int newIndex)
          將 columnIndex 位置的列及其頭移至 newIndex
 void removeColumn(TableColumn column)
          從 tableColumns 陣列中刪除 TableColumn column
 void removeColumnModelListener(TableColumnModelListener x)
          移除表列模型事件的偵聽器。
 void setColumnMargin(int newMargin)
          將 TableColumn 的列空白設置為 newMargin
 void setColumnSelectionAllowed(boolean flag)
          設置是否可以選擇此模型中的列。
 void setSelectionModel(ListSelectionModel newModel)
          設置選擇模型。
 

方法詳細資訊

addColumn

void addColumn(TableColumn aColumn)
aColumn 追加到 tableColumns 陣列的結尾。此方法向其偵聽器發送一個 columnAdded 事件。

參數:
aColumn - 要添加的 TableColumn
另請參見:
removeColumn(javax.swing.table.TableColumn)

removeColumn

void removeColumn(TableColumn column)
tableColumns 陣列中刪除 TableColumn column。如果 column 不處於該表各列的列表中,則此方法不執行任何操作。此方法向其偵聽器發送一個 columnRemoved 事件。

參數:
column - 要移除的 TableColumn
另請參見:
addColumn(javax.swing.table.TableColumn)

moveColumn

void moveColumn(int columnIndex,
                int newIndex)
columnIndex 位置的列及其頭移至 newIndex。原位於 columnIndex 位置的列現在將在 newIndex 處找到。將原位於 newIndex 位置的列向左或向右移動以留出空間。如果 columnIndex 等於 newIndex,則不移動任何列。此方法向其偵聽器發送一個 columnMoved 事件。

參數:
columnIndex - 要移動的列的索引
newIndex - 該列新位置的索引
拋出:
IllegalArgumentException - 如果 columnIndexnewIndex 不在有效範圍內

setColumnMargin

void setColumnMargin(int newMargin)
TableColumn 的列空白設置為 newMargin。此方法向其偵聽器發送一個 columnMarginChanged 事件。

參數:
newMargin - 新列空白的寬度,以像素為單位
另請參見:
getColumnMargin()

getColumnCount

int getColumnCount()
返回該模型中的列數。

返回:
該模型中的列數

getColumns

Enumeration<TableColumn> getColumns()
返回該模型中所有列的 Enumeration

返回:
該模型中所有列的 Enumeration

getColumnIndex

int getColumnIndex(Object columnIdentifier)
返回該表中首列的索引,使用 equals 進行比較時,該列的標識符等於 identifier

參數:
columnIdentifier - 標識符物件
返回:
首個表列的索引,其標識符等於 identifier
拋出:
IllegalArgumentException - 如果 identifiernull,或者沒有 TableColumn 具有此 identifier
另請參見:
getColumn(int)

getColumn

TableColumn getColumn(int columnIndex)
返回 columnIndex 位置列的 TableColumn 物件。

參數:
columnIndex - 所需列的索引
返回:
columnIndex 位置列的 TableColumn 物件

getColumnMargin

int getColumnMargin()
返回每列中單元格之間的寬度。

返回:
單元格之間的空白,以像素為單位

getColumnIndexAtX

int getColumnIndexAtX(int xPosition)
返回位於該水平點 xPosition 位置列的索引;如果該點位於任何列邊界外,則返回 -1。 在維護 Swing 的可分離模型架構的過程中,TableColumnModel 並不瞭解表的各列實際出現在螢幕上的方式。列的虛擬展示由使用此模型(通常是 JTable)的 view/controller 物件負責。view/controller 不必從左到右按順序顯示這些列。例如,為了適應語言環境的優先選擇,可以從右到左顯示各列,或者可能根據使用者的請求隱藏某些列。因為該模型不瞭解各列在螢幕上的排列方式,所以不應將給定的 xPosition 考慮為 2D 圖形空間中的坐標。相反,應將其考慮為從模型中第一列開始的寬度。如果要求 2D 空間中給定 X 坐標的列索引,則可以使用 JTable.columnAtPoint

返回:
列的索引;如果無法找到列,則返回 -1
另請參見:
JTable.columnAtPoint(java.awt.Point)

getTotalColumnWidth

int getTotalColumnWidth()
返回所有列的總寬度。

返回:
計算出的所有列的總寬度

setColumnSelectionAllowed

void setColumnSelectionAllowed(boolean flag)
設置是否可以選擇此模型中的列。

參數:
flag - 如果可以選擇列,則為 true;否則為 false
另請參見:
getColumnSelectionAllowed()

getColumnSelectionAllowed

boolean getColumnSelectionAllowed()
如果可以選擇列,則返回 true。

返回:
如果可以選擇列,則返回 true
另請參見:
setColumnSelectionAllowed(boolean)

getSelectedColumns

int[] getSelectedColumns()
返回所有選定列的索引陣列。

返回:
包含所有選定列索引的整數陣列;如果沒有選定的列,則返回一個空陣列

getSelectedColumnCount

int getSelectedColumnCount()
返回選定的列數。

返回:
選定的列數;如果沒有選定的列,則返回 0

setSelectionModel

void setSelectionModel(ListSelectionModel newModel)
設置選擇模型。

參數:
newModel - ListSelectionModel 物件
另請參見:
getSelectionModel()

getSelectionModel

ListSelectionModel getSelectionModel()
返回當前的選擇模型。

返回:
ListSelectionModel 物件
另請參見:
setSelectionModel(javax.swing.ListSelectionModel)

addColumnModelListener

void addColumnModelListener(TableColumnModelListener x)
為表列模型事件添加偵聽器。

參數:
x - TableColumnModelListener 物件

removeColumnModelListener

void removeColumnModelListener(TableColumnModelListener x)
移除表列模型事件的偵聽器。

參數:
x - TableColumnModelListener 物件

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only