Java中JTable的用法

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是使用data和columnNames構成的：
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的所見即所得 (WYSIWYG)的實現來確定的。你可以使用下面的方法來更改選擇的顏色：
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應用程式所產生的表格的格式化，這樣就能夠讓你的使用者在進行正常使用的時候不碰到障礙。

----------------------------------------------------------------------------------------------------------------------------------

import java.awt.Dimension;
import javax.swing.JFrame;
import javax.swing.JScrollPane;
import javax.swing.JPanel;
import javax.swing.JTable;
import java.awt.Color;
import java.awt.GridLayout;
import javax.swing.table.TableColumn;

public class JTableDemo
{
 public static void main (String[] args)
 {
  /*
  建構函式有很多下面先介紹幾個:
  JTable()
  JTable(int numRows, int numColumns)
  JTable(Object[][] rowData, Object[] columnNames)
  */
  
  JTable example1 = new JTable ();//看不到但存在
  
  JTable example2 = new JTable (8, 6);
  
  
  final Object[] columnNames = {"姓名", "性別", "家庭地址",//列名最好用final修飾
   "電話號碼", "生日", "工作", "收入", "婚姻狀況","戀愛狀況"};
  Object[][] rowData = {
     {"ddd", "男", "江蘇南京", "1378313210", "03/24/1985", "學生", "寄生中", "未婚", "沒"},
     {"eee", "女", "江蘇南京", "13645181705", "xx/xx/1985", "家教", "未知", "未婚", "好象沒"},
     {"fff", "男", "江蘇南京", "13585331486", "12/08/1985", "汽車推銷員", "不確定", "未婚", "有"},
     {"ggg", "女", "江蘇南京", "81513779", "xx/xx/1986", "賓館服務員", "確定但未知", "未婚", "有"},
     {"hhh", "男", "江蘇南京", "13651545936", "xx/xx/1985", "學生", "流放中", "未婚", "無數次分手後沒有"}
    };
  
  
  JTable friends = new JTable (rowData, columnNames);
  friends.setPreferredScrollableViewportSize(new Dimension(600, 100));//設定表格的大小
  friends.setRowHeight (30);//設定每行的高度為20
  friends.setRowHeight (0, 20);//設定第1行的高度為15
  friends.setRowMargin (5);//設定相鄰兩行儲存格的距離
  friends.setRowSelectionAllowed (true);//設定可否被選擇.預設為false
  friends.setSelectionBackground (Color.white);//設定所選擇行的背景色
  friends.setSelectionForeground (Color.red);//設定所選擇行的前景色彩
  friends.setGridColor (Color.black);//設定網格線的顏色
  friends.selectAll ();//選擇所有行
  friends.setRowSelectionInterval (0,2);//設定初始的選擇行,這裡是1到3行都處於選擇狀態
  friends.clearSelection ();//取消選擇
  friends.setDragEnabled (false);//不懂這個
  friends.setShowGrid (false);//是否顯示網格線
  friends.setShowHorizontalLines (false);//是否顯示水平的網格線
  friends.setShowVerticalLines (true);//是否顯示垂直的網格線
  friends.setValueAt ("tt", 0, 0);//設定某個儲存格的值,這個值是一個對象
  friends.doLayout ();
  friends.setBackground (Color.lightGray);
  
  
  JScrollPane pane1 = new JScrollPane (example1);//JTable最好加在JScrollPane上
  JScrollPane pane2 = new JScrollPane (example2);
  JScrollPane pane3 = new JScrollPane (friends);

  JPanel panel = new JPanel (new GridLayout (0, 1));
  panel.setPreferredSize (new Dimension (600,400));
  panel.setBackground (Color.black);
  panel.add (pane1);
  panel.add (pane2);
  panel.add (pane3);
  
  JFrame frame = new JFrame ("JTableDemo");
  frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE);
  
  frame.setContentPane (panel);
  
  frame.pack();
  frame.show();
  
 }
}