?

Swing頗受歡迎的JTable類為顯示大塊數據提供了一種簡單的機制。JTable有很多東西是用于數據的生成和編輯,其中的很多東西還可以自定義,從而更進一步增強其功能。本文會引導你一步步地進入JTable的世界。

Listing A包含了一個簡單示例的代碼,這個示例會說明常用JTable的行為。用戶能夠更改JTable的布局、拖放它的欄,或者通過拖動標題的分隔線來改變其大小。

這些列被保存在一個String數組里:
String[] columnNames = {"Product","Number of Boxes","Price"};

數據被初始化并保存在一個二維的對象數組里:
Object[][] data =
{
{"Apples", new Integer(5),"5.00"},
???????? {"Oranges", new Integer(3),"6.00"},
???????? {"Pears", new Integer(2),"4.00"},
???????? {"Grapes", new Integer(3),"2.00"},
};


JTable是使用datacolumnNames構成的:
JTable table = new JTable(data, columnNames);

查看JTable

JTable的高度和寬度按照下面的方法來設定:
table.setPreferredScrollableViewportSize(new Dimension(300, 80));

如果JTable的一個列或者JTable窗口自身的大小被重新確定,那么其他列會被相應的縮小或者放大,以適應新的窗口。使用setAutoResizeMode()方法就能夠控制這種行為:
table.setAutoResizeMode(int mode);

mode整數字段可能的值有:
AUTO_RESIZE_OFF
AUTO_RESIZE_NEXT_COLUMN
AUTO_RESIZE_SUBSEQUENT_COLUMNS
AUTO_RESIZE_LAST_COLUMN
AUTO_RESIZE_ALL_COLUMNS

表格的缺省值

單元格內方格坐標線的缺省顏色是Color.gray。要更改這些方格坐標線的顏色,就要用到:
table.setGridColor(Color.black);

你可以用下面的方法來改變行的高度:
table.setRowHeight(intpixelHeight);

各個單元格的高度將等于行的高度減去行間的距離。

在缺省情況下,內容的前景顏色和背景顏色的選擇都是由Swing的所見即所得的實現來確定的。你可以使用下面的方法來更改選擇的顏色:
table.setSelectionBackground(Color.black); table.setSelectionForeground(Color.white);

你也可以隱藏單元格的方格坐標線,就像下面這樣:
table.setShowHorizontalLines(false);
table.setShowVerticalLines(false);


A顯示了一個隱藏了其水平坐標線的JTable。

圖A



列的寬度

JTable組件有幾個控制表格特性的類和接口。TableColumn會不斷追蹤列的寬度,并負責列大小的調整,包括最大和最小寬度。

TableColumnModel管理著TableColumns的集合以及列的選擇。要設置某個列的寬度,就要為表格列的模型設置一個參照。然后,取得想要的TableColumn并調用其setPreferredWidth()方法:
TableColumncolumn = table.getColumnModel().getColumn(0);
column.setPreferredWidth(100);


當用戶拖放列的時候,列的索引并不會發生改變。getColumn(0)方法會一直返回正確的列,無論它出現在屏幕的哪個地方。

標題

JtableHeader會處理JTable標題的顯示。你可以細分JtableHeader以獲得自定義的布局。例如,如果你的應用程序需要一個跨越多個列的標題,那么只用簡單地細分JtableHeader并將它集成到你的JTable里就行了。

你可以通過為當前JTable的JtableHeader設置一個參照或者調用其setReorderingAllowed()方法,來指定標題的重新排序是否被允許:
table.getTableHeader().setReorderingAllowed(false);

類似地,你可以確信列不會因為在列標題之間拖動而改變大小。要達到這個目的,你就要使用setResizingAllowed()方法:
table.getTableHeader().setResizingAllowed(false);

選擇模式

在缺省狀況下,當用戶在JTable里選擇一個單元格的時候,整個行都被選中了。有多種方法能夠讓用戶自定義選擇的方式。利用ListSelectionModel接口,你可以允許用戶選擇單個或者多個行:
table.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);

ListSelectionModel有下面這些字段:

  • SINGLE_SELECTION允許一次選擇一行。
  • SINGLE_INTERVAL_SELECTION允許選擇相鄰的一系列行。
  • MULTIPLE_INTERVAL_SELECTION也允許選擇相鄰的列,但是帶有擴展功能。它允許用戶使用[Ctrl]鍵進行多個互不相鄰的選擇(即選擇不相鄰的行)。

setCellSelectionEnabled()方法讓用戶能夠同時選擇單個單元格或者整個行:
table.setCellSelectionEnabled(true);

如果被設置為是,setCellSelectionEnabled()方法還會允許在選擇行和單個單元格的同時選擇列,如果B所示。

圖B

編輯單元格

我們這個簡單的表格允許用戶編輯表格里的任何單元格。Listing B列出了一個表格,它允許由程序員來決定哪些單元格能夠被編輯。第一步是創建一個自定義的TableModel:
class SimpleTableModel extends AbstractTableModel {}

數據被封裝在TableModel里,當JTable初始化的時候,自定義的TableModel就被作為一個參數傳遞給JTable的構造函數而不是那個二維的對象數組:
? SimpleTableModelmyModel = new SimpleTableModel();
? JTable table = new JTable(myModel);


如果想讓第二列和第三列也變得可以編輯,并把第一列變成恒定的,那么你就要強制替代TableModel的isCellEditable()方法:
public booleanisCellEditable(int row, intcol){
if (col == 0) {return false;}
???????? else????????? {return true; }
}


簡單的表格驗證

你需要確保用戶只輸入整數值,假如說,向第二列(“盒子的數量”這一列)輸入值來強制替代setValueAt()方法,并將驗證邏輯包括進這個新方法里。首先,你要檢查列是否是整數,以及這個列是否只應該包含整數值:
if (data[0][col] instanceof Integer && !(value instanceof Integer))
{… } else { data[row][col] = value;}


然后,檢查被插入的值是否是個整數。如果它不是的,那么這個字段就不應該被更新,而且應該要顯示一條錯誤信息:
try {
data[row][col] = new Integer(value.toString());
} catch (NumberFormatException e) {
JOptionPane.showMessageDialog(SimpleTable.this,
"Please enter only integer values.");
}

背景顏色

Listing C包含了用于ColorTable.java的代碼,它說明了如何向JTable加入顏色。你可以通過強制替代其prepareRenderer()方法來向JTable加入背景顏色:
JTable table = new JTable(data, columnNames){
?? public Component prepareRenderer(TableCellRenderer r, int row, intcol){}
};

然后,插入決定哪些列應該有顏色以及應該是什么顏色的邏輯:
if (col == 2 && !isCellSelected(row, col)){
???? Color bg = new Color(200, 100, 30);
???? c.setBackground(bg);
c.setForeground(Color.white);
}


要注意,當你更改單元格背景顏色的時候,你還應該更該單元格里所顯示的文本的顏色,讓其變得更加易讀。C顯示了一個第一列和第二列加上了顏色的JTable。

圖C



一切皆在掌握中

我們的例子只是JTable其他部分的基礎。通過使用這些工具,你能夠快速和輕易地掌控對Java應用程序所生成的表格的格式化,這樣就能夠讓你的用戶在進行正常使用的時候不碰到障礙。