使用 JTable 类你可以显示表中的数据,也可以允许用户编辑表中的数据,JTable 不包含数据,也不缓存数据,它只是你的数据的壹個视图,下图是一个在滚动窗格中显示的一个典型的表格:
本节的其余部分告诉你如何完成一些表格相关的常用任务。
创建壹個简单的表格
1、点击
Launch 可以使用
Java Web Start 运行
SimpleTableDemo ,或者由你自己来编译运行
SimpleTableDemo.java ;
2、点击包含 "Snowboarding" 的单元格,这壹行都会被选中,说明你已经选择了 Kathy Smith 的数据。壹個特殊的高亮显示说明 "Snowboarding" 单元格是可以编辑的。通常来讲,你可以通过双击单元格来编辑该单元的文本信息。
3、将鼠标指向 "First Name",现在点击鼠标并且拖到右边,如同你所看到的壹样,用户可以重新排列表格中的列名称。
4、将鼠标指向列头的右边缘,现在点击鼠标并且左右拖动,该列宽度发生了改变,并且其它列填充了多出来的空间。
5、调整包含表格的窗口大小,以便它比实际展示需要的空间更大壹些。所有的表格元素变宽了,水平的填充了多出来的额外空间。
SimpleTableDemo.java 中的表格在 String 数组中声明列名称:
1 | String[] columnNames = { "First Name" , "Last Name" , "Sport" , "# of Years" , "Vegetarian" }; |
它的数据被初始化并且存储在壹個二维的对象数组中:
2 | { "Kathy" , "Smith" , "Snowboarding" , new Integer( 5 ), new Boolean( false )}, |
3 | { "John" , "Doe" , "Rowing" , new Integer( 3 ), new Boolean( true )}, |
4 | { "Sue" , "Black" , "Knitting" , new Integer( 2 ), new Boolean( false )}, |
5 | { "Jane" , "White" , "Speed reading" , new Integer( 20 ), new Boolean( true )}, |
6 | { "Joe" , "Brown" , "Pool" , new Integer( 10 ), new Boolean( false )} |
然后表格对象使用 data 和 columnNames 完成构建。
1 | JTable table = new JTable(data, columnNames); |
壹共有两個 JTable 构造方法直接接受数据,SimpleTableDemo 使用第壹种:
1 | JTable(Object[][] rowData, Object[] columnNames) |
2 | JTable(Vector rowData, Vector columnNames) |
这些构造方法的优点就是它们非常易用,然而,这些构造方法也有它的缺点:
他们设置每個单元格可编辑;
他们以相同的方式对待所有的数据类型(全部识别为 String)。比如说,如果表中的某壹列包含 Boolean 数据,表格可以将该数据显示为壹個复选框。因此,如果你使用上述两個构造方法中任意壹個,你的 Boolean 数据都会被显示为字符串。你可以在上图中的 Vegetarian 列中查看这种差异。
他们要求你把所有的数据都存储在壹個二维数组或者 Vector 对象中,但是这样做对于某些情况下的数据是不合适的。比如说,如果你从数据库中初始化壹系列数据,你可能希望直接查询对象以获取结果,而不是把所有的结果都复制到数组或者 Vector 中。
如果你希望绕过这些限制,你需要实现自己的 Table Model,可以参考
创建壹個 Table Model。
增加壹個表格到容器中
如下是壹段典型的创建壹個卷动窗格作为表格的容器的代码:
1 | JScrollPane scrollPane = new JScrollPane(table); |
2 | table.setFillsViewportHeight( true ); |
上面两行代码做了如下事情:调用 JScrollPane 构造方法并传入 table 对象作为其参数,这句话为 table 对象创建了壹個滚动窗格,table 被自动添加到该容器中;
调用
JTable.setFillsViewportHeight() 设置了fillsViewportHeight 属性,设置表格是否需要大到足以填充封闭视图的全部高度。当这個属性为 true 时,表格对象使用容器的所有高度,哪怕没有足够多的行来使用垂直的空间,这样做可以更加容易的使用表格作为拖拽的目标。
滚动空格自动的将表头放在了顶端,当表格中的数据滚动时仍然可以看到列名显示在顶上。
如果你使用表格却不包含滚动空格,那么你需要获取表头组件并且自己来放置它,比如说像下面这样:
1 | container.setLayout( new BorderLayout()); |
2 | container.add(table.getTableHeader(), BorderLayout.PAGE_START); |
3 | container.add(table, BorderLayout.CENTER); |
设置和更改列宽度
默认情况下,表中所有的列开始时都是等宽的,并且所有的列会自动填充表格的整個宽度。当表格变宽或者变窄(当用户调整包含表格的窗口时会发生),所有的列宽会自动适应变化。
当用户通过拖动列的右边缘来调整列宽度时,其它列必须改变宽度,或者表格的宽度也必须改变。默认情况下,表格的宽度会保持原样,所有拖拽点右左边的列会调整以适应右边的空间增大,所有拖拽点左边的列会调整以适应左边的空间减少。
如果希望自定义初始的列宽,对于你的表格中的每壹列,你可以调用 setPreferredWidth 方法来进行设置。这会设置推荐宽度和他们的近似相对宽度。比如说:增加如下代码到 SimpleTableDemo 会让第三列比其它列要宽壹些。
1 | TableColumn column = null ; |
2 | for ( int i = 0 ; i < 5 ; i++) { |
3 | column = table.getColumnModel().getColumn(i); |
5 | column.setPreferredWidth( 100 ); |
7 | column.setPreferredWidth( 50 ); |
如同上述代码显示的壹样,表格的每壹列都由壹個
TableColumn 对象表示。TableColumn 为列宽度的最小值,推荐值,最大值提供了 getter 和 setter 方法,同样也提供了获取当前列宽度的方法。比如说,基于壹個近似的空间设置需要绘制的单元格元素的宽度,可以参考
TableRenderDemo.java 的 initColumnSizes() 方法。
当用户明确的调整宽度时,
列的首选宽度设置为用户指定的尺寸,同时变成列的当前宽度。然而,当表格自己调整时(通常因为窗口调整了)列的推荐宽度则不会改变,存在的首选宽度用于计算新的列宽以填充可用的空间。
你可以通过调用
setAutoResizeMode(int) 方法改变表格的宽度调整行为。
用户的选择
在这個默认配置下,表格支持选择壹行或者多行,用户可以选择连续的几行。最后一个单元格指示的用户得到一个特殊的迹象,在金属的视觉上看,这個元素超出了轮廓,它有时被称作焦点元素或者当前元素,用户使用鼠标或者键盘来做出选择,具体描述见下表:
操作 | 鼠标动作 | 键盘动作 |
选择单行 | 单击 | 上下光标键 |
延伸的连续选择 | Shift + 单击 或者在表格行上拖动 | Shift + 上下光标键 |
添加行选择/切换行选择 | Ctrl + 单击 | 移动控制向上箭头或下箭头选择控制铅,然后使用空格键添加到选择或控制,空格键切换行选择。 |
要查看选择行是如何执行的,请点击
Launch 以使用
Java™ Web Start 来运行
TableSelectionDemo.java,或者由你自己来编译运行这個
例子。
这個样例程序展示了相似的表格,允许用户操纵特定的 JTable 选项。它还有壹個文本面板记录选择事件。在下方的截图中,壹個用户运行程序,单击第壹行,然后 Ctrl + 单击第三行,注意点击的最后壹個单元格周围的轮廓,这就是突出率先选择的金属外观和感觉。
在"Selection Mode"下方有几個单选按钮,点击标签是"Single Selection"的按钮。现在你可以每次只选择壹行了。如果你点击标签是"Single Interval Selection"的单选按钮,你可以选择连续的壹组行记录。所有的"Selection Mode"下方的单选按钮都调用了方法 JTable.setSelectionMode 这個方法只接受壹個参数,且必须是类 javax.swing.ListSelectionModel 中的常量值之壹,如下所示:MULTIPLE_INTERVAL_SELECTION,SINGLE_INTERVAL_SELECTION 还有 SINGLE_SELECTION。
回到 TableSelectionDemo,注意在"Selection Options"下方的三個复选框,每個复选框控制壹個 boolean 型的由 JTable 定义的绑定变量:
"行选择" 控制行选择,对应的有两個方法 setRowSelectionAllowed() 和 getRowSelectionAllowed()。当这個绑定属性为 true,并且 columnSelectionAllowed 的属性值为 false 时,用户可以选择行记录;
"列选择" 控制列选择,对应的有两個方法 setColumnSelectionAllowed() 和 getColumnSelectionAllowed()。当这個绑定属性为 true,并且 rowSelectionAllowed 绑定属性为 false 时,用户可以选择列记录;
"单元格选择" 控制单元格选择,对应的有两個方法 setCellSelectionEnabled() 和 getCellSelectionEnabled()。当这個绑定属性为 true 时,用户可以选择单個单元格或者矩形块状的单元格;
注意:JTable 使用非常简单的选择概念管理行和列的交叉点,
它不是设计来处理完全独立的单元格选择的。
如果你清除所有的三個复选框,将三個绑定属性设置为 false,那麽就不会有选择。只有高亮元素显示。
你可能会注意到在间隔选择模式下 "Cell Selection" 复选框被禁用。这是因为在演示中,不支持这种模式下的单元格选择。你可以在间隔选择模式下指定单元格的选择,但是结果集是壹個不会产生任何有效选择的表格。
你同样可能注意到更改任意三個选项都会影响到其它选项,这是因为同时允许行选择和列选择和允许单元格选择完全壹样,JTable 自动更新了三個绑定变量以保持它们的壹致性。
注意:设置 cellSelectionEnabled 到某個值会对 rowSelectionEnabled 和 columnSelectionEnabled 有边缘影响,它们也会被设置为这個值。同时设置 rowSelectionEnabled 和 columnSelectionEnabled 到某個值同样对 cellSelectionEnabled 有边缘影响,它也会被设置为那個值。设置 rowSelectionEnabled 和 columnSelectionEnabled 为不同的值会对 cellSelectionEnabled 有边缘影响,它会被设置为 false。
为了获取当前选择,使用 JTable.getSelectedRows 会返回选择的所有行下标,使用 JTable.getSelectedColumns 会返回所有的列下标。 要检索率先选择的坐标,参照表和表的列模型的选择模型。下面的代码格式化包含率先选择的行和列的字符串:
1 | String.format( "Lead Selection: %d, %d. " , table.getSelectionModel().getLeadSelectionIndex(), table.getColumnModel().getSelectionModel().getLeadSelectionIndex()); |
使用选择功能生成壹系列的事件。请参考 编写事件监听器 课程的 如何编写壹系列选择事件监听器 这壹节。
注意:选择数据实际描述为在视图中选择单元格 (表格数据就像它排序或者过滤之后显示出来的壹样) 而不是选择表格的 Model。这個区别不会影响你,除非你查看重新排列的数据,包括排序,过滤或者用户操作过的行。在这种情况下,你必须使用在排序和过滤中提到的转换方法转换选择坐标。
创建壹個 Table Model
每個表对象使用壹個 table model 对象来管理实际的表数据。table model 对象必须实现 TableModel 接口。如果开发人员不提供 table model 对象的定义,那么 JTable 会自动创建壹個 DefaultTableModel 类的实例,这种关系如下图所示。
用 SimpleTableDemo 作为 table model 构造 JTable 表格的示例代码如下:
01 | new AbstractTableModel() { |
02 | public String getColumnName( int col) { |
03 | return columnNames[col].toString(); |
05 | public int getRowCount() { return rowData.length; } |
06 | public int getColumnCount() { return columnNames.length; } |
07 | public Object getValueAt( int row, int col) { |
08 | return rowData[row][col]; |
10 | public boolean isCellEditable( int row, int col) |
12 | public void setValueAt(Object value, int row, int col) { |
13 | rowData[row][col] = value; |
14 | fireTableCellUpdated(row, col); |
如同上述代码所示,实现壹個 table model 可以很简单。通常来讲,你可以在
AbstractTableModel 的子类里来实现你自己的 Table Model。你的 model 可能把数据保存在 Array,Vector 或者哈希表中,或者它也可以从外部源获取数据,比如说从数据库获取数据。它甚至可以在运行期间生成表数据。
这個表格与 SimpleTableDemo 在如下几個地方存在不同点:
1、TableDemo 的自定义 table model 哪怕很简单,它也可以决定数据的类型,帮助 JTable 以更好的格式展示数据。从另壹方面讲,SimpleTableDemo 自动创建的 table model 并不知道列 # of Years 包含靠右对齐的数字,并且具有特殊的格式。它不知道列 Vegerarian 包含布尔型值,可以将其展示成复选框。
2、在 TableDemo 中实现的自定义 table model 不允许你编辑姓名列,然而它允许你编辑其它列。在 SimpleTableDemo 中,所有的元素都是可以编辑的。
可以看到来自 TableDemo.java 的如下代码和来自 SimpleTableDemo.java 的不壹样。黑体字显示创建表格的 model 与为创建 SimpleTableDemo 而自动生成的 table model 不壹样。
03 | JTable table = new JTable( new MyTableModel()); |
07 | class MyTableModel extends AbstractTableModel { |
08 | private String[] columnNames = ... |
09 | private Object[][] data = ... |
11 | public int getColumnCount() { |
12 | return columnNames.length; |
15 | public int getRowCount() { |
19 | public String getColumnName( int col) { |
20 | return columnNames[col]; |
23 | public Object getValueAt( int row, int col) { |
24 | return data[row][col]; |
27 | public Class getColumnClass( int c) { |
28 | return getValueAt( 0 , c).getClass(); |
32 | public boolean isCellEditable( int row, int col) { |
37 | public void setValueAt(Object value, int row, int col) { |
38 | data[row][col] = value; |
39 | fireTableCellUpdated(row, col); |
监控数据的更新
当表格中的数据发生改变时,每個 table model 都可以有壹系列的监听器,监听器都是 TableModelListener 的实例。在如下代码中,SimpleTableDemo 继承了这样壹個监听器。
01 | import javax.swing.event.*; |
02 | import javax.swing.table.TableModel; |
04 | public class SimpleTableDemo ... implements TableModelListener { |
06 | public SimpleTableDemo() { |
08 | table.getModel().addTableModelListener( this ); |
12 | public void tableChanged(TableModelEvent e) { |
13 | int row = e.getFirstRow(); |
14 | int column = e.getColumn(); |
15 | TableModel model = (TableModel)e.getSource(); |
16 | String columnName = model.getColumnName(column); |
17 | Object data = model.getValueAt(row, column); |
发起数据更新事件
为了发起数据更新的事件,table model 必须知道如何创建壹個 TableModelEvent 对象。这可以是壹個复杂的过程,但是它现在已经在 DefaultTableModel 中实现了。你既可以允许 JTable 使用默认的DefaultTableModel 实例,也可以创建你自己的 DefaultTableModel 的自定义的子类。我的理解,发起数据更新事件的含义就是,当数据改变时,通知所有相关的监听器,让它们知道某行某列的数据发生了改变,就是这样。如果 DefaultTableModel 对于你自定义的 table model 类而言不适用,你就可以考虑继承 AbstractTableModel 类实现壹個子类。这個类为创建 TableModelEvent 对象实现了壹個简单的框架。你的自定义类只需要在每次表数据被外部源改变时,简单的调用如下的 AbstractTableModel 方法。
方法名 | 发生的变化 |
fireTableCellUpdated(int row, int column) | 更新了某個单元格,其坐标为(row, column) |
fireTableRowsUpdated(int firstRow, int lastRow) | 更新了从 firstRow 到 lastRow 的行记录,包括 firstRow 和 lastRow |
fireTableDataChanged() | 更新了整個表格中的数据 |
fireTableRowsInserted(int firstRow, int lastRow) | 在行的范围[firstRow, lastRow]内已经插入新的数据,包含 firstRow 和 lastRow |
fireTableRowsDeleted(int firstRow, int lastRow) | 在行范围[firstRow, lastRow]内存在的行被删除了,包含 firstRow 和 lastRow |
fireTableStructureChanged() | 整個表格失效,包括表中的数据和表的结构 |
相关内容:编辑器和渲染器
在你开始继续接下来几個任务之前,你需要理解表格是如何画出它们的单元格。你可能期望每個表格中的单元格都是壹個组件。然而,出于性能方面考虑,Swing 的表格的实现是不壹样的。
相反,单独壹個单元格渲染器通常可以用来画出所有的包含相同数据类型的单元格。你可以将渲染器想象成壹個可配置的墨水印章,表格使用它来给适当格式化的数据盖章。当用户开始编辑单元格中的数据时,壹個单元格渲染器接手单元格,控制单元格的编辑行为。
举例来说,TableDemo 中的每個# of Years 列的单元格包含 Number 型数据,比较特殊,是 Integer 对象。默认情况下,单元格渲染器对于壹個包含数字的列,在每個列中的单元格上都使用壹個 JLable 实例来画出合适的数字,靠右对齐。如果用户开始编辑其中壹個单元格,默认的单元格编辑器使用靠右对齐的 JTextField 来控制单元格的编辑。
为了选择渲染器来显示列中的单元,你首先需要决定表格是否需要为特定的列使用特定的渲染器。如果不需要,那么表格调用 table model 的 getColumnClass 方法,后者将会获取列中元素的数据类型,下壹步,表格中列的数据类型与壹個数据类型列表比较,数据类型列表中的元素渲染器已经注册过。这個列表由表格来完成初始化,但是你可以增加或者改变它。目前,表格将如下类型的数据放进列表中:
3 | Double, Float — 和 Number 类型壹样,但是壹個 NumberFormat 实例会完成对象到文本的转换,针对当前语言使用默认的数字格式; |
4 | Date — 被渲染成壹個标签,但是壹個 DateFormat 实例会完成对象到文本的转换,针对时间和日期使用壹种简短的风格; |
5 | ImageIcon, Icon — 被渲染成壹個居中对齐的标签; |
6 | Object — 被渲染成壹個显示对象的字符串值的标签; |
单元格编辑器的选择使用类似的算法。
记住,如果你允许壹個表格使用它自己的 model ,它就会使用 Object 作为每個列的类型。为了指定更加精确的列类型,table model 必须定义恰当的 getColumnClass() 方法。就像 TableDemo.java 的演示代码那样。牢记尽管渲染器决定每個单元格或者列头部如何展示,以及它们的 tool tip 文本是什么,但是渲染器不处理事件。如果你需要获取发生在表格中的事件,你需要使用技术不同的你感兴趣的事件排序:
情况 | 如何获取事件 |
检测单元格被编辑的事件 | 使用单元格编辑器,或者在单元格编辑器上注册壹個监听器 |
检测行、列或者单元格的选择与反选事件 | 使用 Detecting User Selections 中提到的选择监听器 |
在列的头部检测鼠标事件 | 在表格的 JTableHeader 对象中注册 mouse listener 的合适类型。请查阅 TableSorter.java 中的实例。 |
检测其它事件 | 为 JTable 对象注册合适的监听器 |
下述几章会告诉你如何自定义显示,以及通过特殊的渲染器和编辑器进行编辑。你要么在列上指定单元格渲染器和编辑器,要么在数据类型上指定单元格渲染器和编辑器。
使用自定义的渲染器
这壹章节告诉我们如何创建和指定壹個单元格的渲染器。你可以使用 JTable 的方法 setDefaultRenderer() 来设置壹個指定类型的单元格渲染器。为了让某個特殊列里面的单元格使用指定的渲染器,你可以使用 TableColumn 的 setCellRenderer() 方法。你甚至可以通过创建 JTable 的子类来指定壹個特定于单元格的渲染器。
使用 DefaultTableCellRenderer 可以很容易的自定义文本或者图片的默认渲染器,你只需要创建壹個子类并且实现 setValue() 方法以便它可以使用合适的字符串或者图片来调用 setText() 或者 setIcon() 方法。举個例子,这里是壹個默认的日期类渲染器的实现:
01 | static class DateRenderer extends DefaultTableCellRenderer { |
03 | public DateRenderer() { super (); } |
05 | public void setValue(Object value) { |
06 | if (formatter== null ) { |
07 | formatter = DateFormat.getDateInstance(); |
09 | setText((value == null ) ? "" : formatter.format(value)); |
如果扩展 DefaultTableCellRenderer 还不够,你可以使用另外壹個子类创建壹個渲染器。最简单的方法就是创建壹個已经存在的组件的子类,实现 TableCellRenderer 接口来创建你自己的子类。TableCellRenderer 只需要实现壹個方法:getTableCellRendererComponent()。你对这個方法的实现应该设置渲染组件,以反映传入的状态,然后返回组件。
在 TableDialogEditDemo 的截图中,用于 Favorite Color 单元格上的渲染器是壹個 JLabel 的子类,被称作 ColorRenderer。这里有壹個来自于 ColorRenderer.java 的片段用于展示它是如何实现的。
01 | public class ColorRenderer extends JLabel implements TableCellRenderer { |
03 | public ColorRenderer( boolean isBordered) { |
04 | this .isBordered = isBordered; |
09 | public Component getTableCellRendererComponent( |
10 | JTable table, Object color, |
11 | boolean isSelected, boolean hasFocus, |
12 | int row, int column) { |
13 | Color newColor = (Color)color; |
14 | setBackground(newColor); |
20 | setBorder(selectedBorder); |
25 | setBorder(unselectedBorder); |
这里是来自
TableDialogEditDemo.java 的壹段代码注册了壹個 ColorRenderer 实例作为所有颜色的数据的默认渲染器:
1 | table.setDefaultRenderer(Color. class , new ColorRenderer( true )); |
为了给特定单元格指定渲染器,你需要定义壹個 JTable 子类,重载 getCellRenderer() 方法。举個例子,下述的代码让表格中的第壹列的第壹個单元格使用特定的渲染器:
01 | TableCellRenderer weirdRenderer = new WeirdRenderer(); |
02 | table = new JTable(...) { |
03 | public TableCellRenderer getCellRenderer( int row, int column) { |
04 | if ((row == 0 ) && (column == 0 )) { |
08 | return super .getCellRenderer(row, column); |
为单元格指定工具提示信息
默认情况下,显示在表中单元格上的工具提示文本由单元格的渲染器决定。然而,有时候通过重载 JTable 的实现中的 getToolTipText(MonseEvent e) 方法可以更加简单指定工具提示文本。这壹章节向你展示如何使用这两個技术。
为了在壹個单元格的渲染器上增加工具提示,你首先需要获得或者创建壹個单元格渲染器。然后,确保渲染器组件是壹個 JComponent,调用它的 setToolTipText() 方法即可。
TableRenderDemo 中有壹個为单元格设置工具提示的例子。点击这里可以运行该样例代码,当然你也可以自己编译运行它的源代码。它使用如下代码在 Sport 列中为单元格添加了工具提示:
1 | DefaultTableCellRenderer renderer = new DefaultTableCellRenderer(); |
2 | renderer.setToolTipText( "Click for combo box" ); |
3 | sportColumn.setCellRenderer(renderer); |
虽然上個例子里的工具提示文本样例是静态的,但是你也可以实现随着单元格状态改变而改变的工具提示文本程序,这里有两种实现的方法:
1、在渲染器的 getTableCellRendererComponent() 方法实现中增加壹些代码;
2、重载 JTable 的 getToolTipText(MonseEvent e)方法;
壹個在单元格渲染器中添加代码的例子是 TableDialogEditDemo。点击启动按钮可以运行这個例子,或者你也可以自行编译运行这個例子。TableDialogEditDemo 使用了壹個用于颜色的渲染器,并且在 ColorRender.java 中实现了它。
01 | public class ColorRenderer extends JLabel |
02 | implements TableCellRenderer { |
04 | public Component getTableCellRendererComponent( |
05 | JTable table, Object color, |
06 | boolean isSelected, boolean hasFocus, |
07 | int row, int column) { |
08 | Color newColor = (Color)color; |
10 | setToolTipText( "RGB value: " + newColor.getRed() + ", " |
11 | + newColor.getGreen() + ", " |
12 | + newColor.getBlue()); |
下图是工具栏提示运行时的效果:
通过重载 JTable 的 getToolTipText(MouseEvent e) 方法你可以指定工具栏提示文本,程序 TableToolTipsDemo 展示了该如何进行。Sport 和 Vegetarian 两個列中的元素具有工具栏提示,它们的演示效果如下:
这是来自 TableToolTipsDemo 中的壹段代码,它实现了在 Sport 和 Vegetarian 列中的元素上添加工具栏提示的功能。
01 | JTable table = new JTable( new MyTableModel()) { |
03 | public String getToolTipText(MouseEvent e) { |
05 | java.awt.Point p = e.getPoint(); |
06 | int rowIndex = rowAtPoint(p); |
07 | int colIndex = columnAtPoint(p); |
08 | int realColumnIndex = convertColumnIndexToModel(colIndex); |
10 | if (realColumnIndex == 2 ) { |
11 | tip = "This person's favorite sport to " |
12 | + "participate in is: " |
13 | + getValueAt(rowIndex, colIndex); |
15 | } else if (realColumnIndex == 4 ) { |
16 | TableModel model = getModel(); |
17 | String firstName = (String)model.getValueAt(rowIndex, 0 ); |
18 | String lastName = (String)model.getValueAt(rowIndex, 1 ); |
19 | Boolean veggie = (Boolean)model.getValueAt(rowIndex, 4 ); |
20 | if (Boolean.TRUE.equals(veggie)) { |
21 | tip = firstName + " " + lastName |
24 | tip = firstName + " " + lastName |
25 | + " is not a vegetarian" ; |
32 | tip = super .getToolTipText(e); |
该代码是相当简单的,除非是调用convertColumnIndexToModel()。该调用是必要的,因为如果用户移动周围的列,列的视图的索引将不匹配模型的索引列。例如,用户可以拖动 Vegetarian 列(假设该模型的列在索引4),使得它可以显示作为第一列 - 此时视图索引为0。由于prepareRenderer提供视图索引,您需要转换视图索引到模型索引,这样你才可以确信该列已选定。
为表头指定工具提示信息
通过为你的表格的 JTableHeader设置工具提示文本,你可以增加壹個工具提示到列的头部。通常不同的列头部需要不同的工具提示信息。通过重载表格头的 getToolTipText() 方法你可以改变文本信息。你可以交替的调用 TableColumn.setHeaderRenderer() 方法来为表头提供自定义的渲染器。
在 TableSorterDemo.java 中有壹個为所有列的头部使用工具提示文本的例子,如下是如何设置工具提示信息的代码:
1 | table.getTableHeader().setToolTipText( "Click to sort; Shift-Click to sort in reverse order" ); |
TableToolTipsDemo.java 中实现了壹個根据列的头部给出不同的工具提示信息的例子。除了最初的两個以外,当你的鼠标划过任何列的头部时,你会看见工具提示信息。因为他们似乎不言自明,所以没有为这些名称列提供工具提示信息。
接下来的代码实现了工具提示功能,基本上,它创建了壹個 JTableHeader 的子类并且重载了 getToolTipText(MonseEvent e)方法,以便它可以为当前列返回文本。为了关联修改表的表头,JTable 中的 createDefaultTableHeader() 方法被重载了,以便它返回壹個 JTableHeader 子类的实例。
01 | protected String[] columnToolTips = { |
04 | "The person's favorite sport to participate in" , |
05 | "The number of years the person has played the sport" , |
06 | "If checked, the person eats no meat" }; |
09 | JTable table = new JTable( new MyTableModel()) { |
13 | protected JTableHeader createDefaultTableHeader() { |
14 | return new JTableHeader(columnModel) { |
15 | public String getToolTipText(MouseEvent e) { |
17 | java.awt.Point p = e.getPoint(); |
18 | int index = columnModel.getColumnIndexAtX(p.x); |
20 | columnModel.getColumn(index).getModelIndex(); |
21 | return columnToolTips[realIndex]; |
排序与过滤数据
表格的排序和过滤由壹個 sorter 对象进行管理,最简单的提供 sorter 对象的方法是设置 autoCreateRowSorter 绑定属性为 true:
1 | JTable table = new JTable(); |
2 | table.setAutoCreateRowSorter( true ); |
这次我们定义壹個行排序 sorter,它是 javax.swing.table.TableRowSorter 的壹個实例。当用户点击列的头部时,排序工具提供给表格壹個简单的基于当地的排序。TableSortDemo.java 就是这样壹個演示的例子,下图是截屏:
要想获取更多关于排序的控制,你可以创建壹個 TableRowSorter 的实例并且指定它是你的表格中的排序对象。
1 | TableRowSorter<TableModel> sorter = new TableRowSorter<TableModel>(table.getModel()); |
2 | table.setRowSorter(sorter); |
TableRowSorter 使用 java.util.Comparator 对象来完成行排序。壹個实现了这样接口的类提供壹個 compare() 方法用于定义任意两個对象为了完成排序应该如何进行比较。举例来说,下述的代码创建了壹個比较器,用于对比壹系列的字符串通过对比每個字符串最后壹個字母来进行排序:
1 | Comparator<String> comparator = new Comparator<String>() { |
2 | public int compare(String s1, String s2) { |
3 | String[] strings1 = s1.split( "\s" ); |
4 | String[] strings2 = s2.split( "\s" ); |
5 | return strings1[strings1.length - 1 ] |
6 | .compareTo(strings2[strings2.length - 1 ]); |
这個例子是特意简化过的,更有代表性的,壹個比较器的实现是壹個 java.text.Collator 的子类。你可以定义你自己的子类,使用在 Collator 类中的工厂方法来根据指定的语言获得壹個 Comparator 对象,或者使用 java.text.RuleBasedCollator 类。
这個例子是特地简化过的;更常见情况下,Comparator 的实现是 java.text.Collator 的壹個子类。你可以有你自己的子类,使用在 Collator 类的工厂方法可以获取壹個基于本地环境的 Comparator 实例,或者使用 java.text.RuleBasedCollator 。
对于每壹列应该使用哪种 Comparator ,TableRowSorter 会尝试应用如下规则。规则会按照如下的顺序被遵循;第壹条规则如果已经使用,则后继的规则会被忽略。
1 | 1 、如果已经通过 setComparator() 指定了壹個比较器,则使用该比较器。 |
2 | 2 、如果 table model 已经声明列数据由字符串组成,就是说对于指定列调用 TableModel.getColumnClass() 方法返回 String. class ,使用基于本地环境的字符串顺序进行排序。 |
3 | 3 、如果针对列调用 TableModel.getColumnClass() 之后的返回值实现了 Comparable 接口,则使用 Comparable.compareTo() 方法的返回值的字符串顺序进行排序。 |
4 | 4 、如果表格调用了 setStringConverter() 方法指定了字符串转换器,则使用基于本地环境的字符串的表现形式的字符串排序器排序。 |
5 | 5 、如果以上规则均不适用,则先调用列中数据的 toString() 方法将其转换成字符串类型,然后针对转换后的字符串使用基于本地环境的字符串顺序进行排序。 |
对于更多更加复杂的排序类型,可以继承 TableRowSorteror 的父类 javax.swing.DefaultRowSorter 。
为调用 setSortKeys() 可以指定列的排序顺序和排序优先级。这里有壹個针对表格的前两列进行排序的例子。优先的列可以在排序键的列表中指定。在这种情况下,第二列拥有第壹個排序键,所以这些行先按照 first name 排序,然后再按照 second name 排序。
1 | List <RowSorter.SortKey> sortKeys = new ArrayList<RowSorter.SortKey>(); |
2 | sortKeys.add( new RowSorter.SortKey( 1 , SortOrder.ASCENDING)); |
3 | sortKeys.add( new RowSorter.SortKey( 0 , SortOrder.ASCENDING)); |
4 | sorter.setSortKeys(sortKeys); |
除了重新排序的结果,也可以指定壹個表分拣机指定显示哪些行,这就是所谓的过滤。TableRowSorter 使用 javax.swing.RowFilter 对象实现过滤。RowFilter 实现了几個工厂方法用于创建常用的过滤器类型。举例来说,regexFilter 返回壹個基于正则表达式过滤的 RowFilter。
在如下的样例代码中,你明确的创建壹個排序器对象以便你可以在稍后使用它作为过滤器。
1 | MyTableModel model = new MyTableModel(); |
2 | sorter = new TableRowSorter<MyTableModel>(model); |
3 | table = new JTable(model); |
4 | table.setRowSorter(sorter); |
然后你可以基于文本域的当前值过滤:
1 | private void newFilter() { |
2 | RowFilter<MyTableModel, Object> rf = null ; |
4 | rf = RowFilter.regexFilter(filterText.getText(), 0 ); |
5 | } catch (java.util.regex.PatternSyntaxException e) { |
8 | sorter.setRowFilter(rf); |
在后面的例子中,每次文本域改变时都会调用 newFilter() 方法。当用户输入难懂的正则表达式时,try...catch 会防止干扰和阻止语法端的输入异常。当表格使用了排序器,用户看到的数据可能呈现壹种与 table model 指定的不同的顺序,也有可能包含 table model 所指定的所有数据。用户实际看到的数据被称作视图,它有自己的坐标系。JTable 提供了从 model 坐标系到视图坐标系的转换方法: convertColumnIndexToView() 和 convertRowIndexToView() ,也提供了从视图坐标系到 model 坐标系的转换方法:convertColumnIndexToModel() 和 convertRowIndexToModel()。
注意:当使用排序器时,总要记住转换单元格的坐标系。
接下来的例子把我们这节讨论过的所有想法都带来了。TableFilterDemo.java 给 TableDemo 做了壹些小的改变。它们包含在这节之前的代码片段中,作用是为主表提供了壹個排序器,并且使用壹個文本框来提供过滤用的正则表达式。如下的截屏展示了 TableFilterDemo 在排序和过滤操作之前的样子。注意模型中的第三行在视图中也在相同的第三行:
如果用户在第二列上点击两次,第四列就变成了第壹列,但只是在视图中:
就像之前提到的那样,用户在"Filter Text"中输入的文本决定哪些行会显示,同样对于排序,过滤引起视图坐标系偏离模型坐标系:
这里是更新状态文本来映射当前选择的代码:
01 | table.getSelectionModel().addListSelectionListener( |
02 | new ListSelectionListener() { |
03 | public void valueChanged(ListSelectionEvent event) { |
04 | int viewRow = table.getSelectedRow(); |
06 | statusText.setText( "" ); |
08 | int modelRow = table.convertRowIndexToModel(viewRow); |
09 | statusText.setText(String.format( "Selected Row in view: %d. " + "Selected Row in model: %d." , viewRow, modelRow)); |
使用 ComboBox 下拉列表作为编辑器
启用壹個下拉列表作为编辑器很容易,如同下述样例展示的壹样。
01 | TableColumn sportColumn = table.getColumnModel().getColumn( 2 ); |
03 | JComboBox comboBox = new JComboBox(); |
04 | comboBox.addItem( "Snowboarding" ); |
05 | comboBox.addItem( "Rowing" ); |
06 | comboBox.addItem( "Chasing toddlers" ); |
07 | comboBox.addItem( "Speed reading" ); |
08 | comboBox.addItem( "Teaching high school" ); |
09 | comboBox.addItem( "None" ); |
10 | sportColumn.setCellEditor( new DefaultCellEditor(comboBox)); |
这是下拉列表在使用时的效果:
上述代码来自于 TableRenderDemo.java 。
使用其它编辑器
无论你是为单個的列或者单元格设置编辑器(使用TableColumnsetCellEditor的方法)还是为特定的数据类型设置编辑器(使用JTablesetDefaultEditor的方法),你都应该让这個编辑器实现 TableCellEditor 接口。幸运的是,DefaultCellEditor 类实现这个接口,并允许你指定编辑组成部分是一个JTextField,JCheckBox 或者 JComboBox 的构造函数。通常,您不需要明确指定一个复选框作为壹個编辑器,因为布尔数据的列会自动使用复选框渲染器和编辑器。
如果你想指定复选框、下拉列表、文本框编辑器以外的文本字段该如何做呢?由于DefaultCellEditor不支持其他类型的组件,您必须做更多一点的工作。您需要创建一个类实现 TableCellEditor 的接口。 AbstractCellEditor 类是一个很好的超类使用。它实现了 TableCellEditor 的超级接口,CellEditor,减少了您的麻烦同时实现了事件触发单元格编辑器所必需的代码。
你的单元格编辑器需要定义至少两個方法:getCellEditorValue() 和 getTableCellEditorComponent()。 方法 getCellEditorValue() 的定义是 CellEditor 所必需的,它返回单元格的当前值。方法 getTableCellEditorComponent() 则是 TableCellEditor 所必需的,应该配置为返回你希望使用的那個编辑器的组件。
这里有壹個用对话框作为单元格编辑器(不是直接的出现)的表格的图片。当用户开始编辑列 Favorite Color 列中的单元格时,壹個按钮(真正的单元格编辑器)出现并且显示出对话框,在对话框中用户可以选择壹個不壹样的颜色值。
上述代码参见 TableDialogEditDemo.java 。
这是来自 ColorEditor.java 的源代码,它实现了单元格编辑器。
01 | public class ColorEditor extends AbstractCellEditor |
02 | implements TableCellEditor, |
06 | JColorChooser colorChooser; |
08 | protected static final String EDIT = "edit" ; |
10 | public ColorEditor() { |
11 | button = new JButton(); |
12 | button.setActionCommand(EDIT); |
13 | button.addActionListener( this ); |
14 | button.setBorderPainted( false ); |
17 | colorChooser = new JColorChooser(); |
18 | dialog = JColorChooser.createDialog(button, |
26 | public void actionPerformed(ActionEvent e) { |
27 | if (EDIT.equals(e.getActionCommand())) { |
29 | button.setBackground(currentColor); |
30 | colorChooser.setColor(currentColor); |
31 | dialog.setVisible( true ); |
36 | currentColor = colorChooser.getColor(); |
41 | public Object getCellEditorValue() { |
46 | public Component getTableCellEditorComponent(JTable table, |
51 | currentColor = (Color)value; |
就像你看到的壹样,代码很简单。略有点棘手的地方是在编辑器按钮动作处理程序结束的时候需要调用 fireEditingStopped() 方法。没有这個调用,编辑器会仍然保持活动状态,尽管模态对话框已经不再可见。通过调用 fireEditingStopped() 方法可以让表格知道它可以关闭编辑器,让单元格可以再次被渲染器处理。
使用编辑器验证用户输入的文本信息的合法性
如果一个单元格的默认编辑器允许文本输入,如果单元格的类型指定为字符串或对象以外的东西,你会得到一些免费的错误检查。错误检查的副作用是将输入的文字转换成一个对象的正确类型。
自动检查用户输入的字符串时发生在默认编辑器试图创建一个新的单元格的列相关联的类的实例的时候。默认编辑器使用一个String作为参数的构造函数创建这个实例。例如,在一列Integer类型的单元格中,当用户输入“123”的默认编辑器创建相应的整数,使用相当于新的整数(“123”)的代码。如果构造函数抛出异常,单元格的轮廓变成红色,并拒绝让焦点移动的单元格。如果实现列的数据类型作为一类,你可以使用默认的编辑器,如果你的类提供了一个接受一个参数类型为String的构造函数。
如果你想使用壹個文本框作为单元格的编辑器,但是想自定义它 — 可能需要更加严格的检查用户输入,或者当输入文本不合法时用不同的方法重构 — 你可以使用壹個 formatted text field 改变单元格编辑器。用户表明打字(如按Enter键)结束之后,格式化的文本框可以连续检查用户键入后的值。
接下来的代码来自于
TableFTFEditDemo.java ,它设置了壹個格式化文本框作为编辑器,后者限制所有的整型值都必须在 0 到 100 之间。接下来的代码为所有的列创建了壹個包含 Integer 类型数据的格式化文本框:
1 | table.setDefaultEditor(Integer. class , new IntegerEditor( 0 , 100 )); |
IntegerEditor 类是作为 DefaultCellEditor 的壹個子类实现的,并且使用了壹個 JFormattedTextField 代替了 JTextField,后者是由 DefaultCellEditor 支持的。它是通过首先设置壹個使用整型格式的格式化文本框,并且指定最小和最大值,然后使用 How to Use Formatted Text Fields 中提到的 API 实现的。之后它重载了 DefaultCellEditor 的getTableCellEditorComponent(),getCellEditorValue(), 和 stopCellEditing() 方法实现,为格式化文本框增加了必要的操作。
覆盖getTableCellEditorComponent()设置格式的文本字段的值属性(不仅仅是文本的属性,它继承自JTextField的)编辑器显示之前。覆盖getCellEditorValue()保持作为一个整数单元格的值,而不是,比方说,Long值,格式化文本字段的解析器趋于恢复。最后,覆盖stopCellEditing()让你检查文本是否是有效的,可能停止编辑被解雇。如果文本是无效的,你stopCellEditing()的实施提出了一个对话框,让用户选择继续编辑或恢复到最后一个良好的价值。源代码是太长了一点,包括在这里,你也可以查看 IntegerEditor.java 。
打印表格内容
JTable 提供了打印表格的壹個简单的 API。最简单的打印出表格的方法就是不带参数调用 JTable.print() 。
3 | System.err.println( "User cancelled printing" ); |
5 | } catch (java.awt.print.PrinterException e) { |
6 | System.err.format( "Cannot print %s%n" , e.getMessage()); |
在壹個正常的 Swing 应用上调用打印功能会打开壹個标准的打印对话框。在壹個没有表格头的应用中,则简单的打印它。它的返回值表示用户是否继续打印的任务还是放弃打印。JTable.print() 可以抛出 java.awt.print.PrinterException 异常,它是壹個 受检异常 ,这就是为什么我们在例子中要使用壹個 try ... catch 语句来包围它。
JTable 提供了几個 print() 的重载方法,可以使用各种各样的选项来完成打印。如下来自 TablePrintDemo.java 的代码展示了如何定义页面头部:
1 | MessageFormat header = new MessageFormat( "Page {0,number,integer}" ); |
3 | table.print(JTable.PrintMode.FIT_WIDTH, header, null ); |
4 | } catch (java.awt.print.PrinterException e) { |
5 | System.err.format( "Cannot print %s%n" , e.getMessage()); |
如果想了解更多更复杂的表格打印功能,可以使用
JTable.getPrintable() 来从表格中获取壹個 Printable 对象。 关于 Printable 的更多信息,你可以参考
Printing 这壹节课程,它出现在
2D Graphics 系列课程中。
本文的英文原文来自http://docs.oracle.com/javase/tutorial/uiswing/components/table.html ,中文翻译文章首发开源中国社区 http://my.oschina.net/bairrfhoinn/blog/166850 ,转载请注明原始出处。
发表评论 取消回复