Java Swing JTable

1 简介

JTable用于显示和编辑常规的二维单元格表。有关面向任务的文档和使用JTable的示例,请参见Java教程中的如何使用表。
JTable具有许多功能,可以自定义其呈现和编辑功能,但是为这些功能提供了默认设置,因此可以轻松设置简单的表。例如,要建立一个包含10行10列数字的表:

TableModel dataModel = new AbstractTableModel(){
Public int getColumnCount(){返回10; }
Public int getRowCount(){返回10;}
Public Object getValueAt(int row,int col){返回新的Integer(row * col); }
};
JTable表=新的JTable(dataModel);
JScrollPane scrollpane =新的JScrollPane(table);

JTable通常放置在JScrollPane内部。默认情况下,JTable将调整其宽度,从而不需要水平滚动条。要允许水平滚动条,请使用AUTO_RESIZE_OFF调用setAutoResizeMode(int)。请注意,如果希望在独立视图中(在JScrollPane外部)使用JTable并希望显示标头,则可以使用getTableHeader()获取它并单独显示它。

要启用行的排序和过滤,请使用RowSorter。您可以通过以下两种方式之一设置行排序器:

直接设置RowSorter。例如:table.setRowSorter(new TableRowSorter(model))。
将autoCreateRowSorter属性设置为true,以便JTable为您创建RowSorter。例如:setAutoCreateRowSorter(true)。

在设计使用JTable的应用程序时,值得密切注意将代表表数据的数据结构。

DefaultTableModel是一个模型实现,它使用对象矢量向量存储单元格值。除了将数据从应用程序复制到DefaultTableModel之外,还可以将数据包装在TableModel接口的方法中,以便可以将数据直接传递到JTable,如上例所示。由于模型可以自由选择最适合数据的内部表示形式,因此通常可以提高应用程序的效率。

确定是使用AbstractTableModel还是DefaultTableModel的一个很好的经验法则是

  • 将AbstractTableModel用作创建子类的基类
  • 而在不需要子类化时使用DefaultTableModel

源分发的演示区域中的“ TableExample”目录提供了一些JTable使用情况的完整示例,涵盖了如何使用JTable提供从数据库获取的数据的可编辑视图以及如何修改显示中的列。使用专门的渲染器和编辑器。

JTable仅使用整数来引用它显示的模型的行和列。 JTable只是采用表格形式的单元格范围,并在绘制过程中使用getValueAt(int,int)从模型中检索值。重要的是要记住,由各种JTable方法返回的列和行索引是根据JTable(视图)而言的,不一定与模型使用的索引相同。

默认情况下,列可能会在JTable中重新排列,以使视图的列以与模型中的列不同的顺序出现。这一点根本不影响模型的实现:对列进行重新排序时,JTable在内部维护列的新顺序并在查询模型之前转换其列索引。

因此,在编写TableModel时,不必侦听列重新排序事件,因为无论视图中发生什么,都将在其自身的坐标系中查询模型。在示例区域中,展示了一种排序算法的演示,该算法正是使用此技术来插入另一个坐标系,在该坐标系中行的顺序发生了变化,而不是列的顺序发生了变化。

同样,使用RowSorter提供的排序和筛选功能时,底层的TableModel不需要知道如何进行排序,而是由RowSorter进行处理。当将JTable的基于行的方法与基础TableModel一起使用时,必须进行坐标转换。所有基于JTables行的方法都是基于RowSorter的,不一定与基础TableModel的相同。例如,选择始终是根据JTable进行的,因此,在使用RowSorter时,您将需要使用convertRowIndexToView或convertRowIndexToModel进行转换。下面显示了如何将JTable的坐标转换为基础模型的坐标:

Int []选择= table.getSelectedRows();
For(int i = 0; i selection.length; i ++){
Selection [i] = table.convertRowIndexToModel(selection [i]);
}
//现在根据基础TableModel进行选择

默认情况下,如果启用了排序,则JTable将根据排序模型保留选择和可变行高。例如,如果第0行

JTable,表格。用来显示和编辑二维表。
添加表格到容器中有两种方式:

  • 添加到普通的中间容器中,此时添加的jTable只是表格的行内容,表头(jTable.getTableHeader())需要额外单独添加。此添加方式适合表格行数确定,数据量较小,能一次性显示完的表格;
  • 添加到JScrollPane滚动容器中,此添加方式不需要额外添加表头,jTable添加到jScrollPane中后,表头自动添加到滚动容器的顶部,并支持行内容的滚动(滚动行内容时,表头会始终在顶部显示)。

构造方法

创建空表格,后续再添加相应数据
JTable()

创建指定行列数的空表格,表头名称默认使用大写字母(A, B, C …)依次表示
JTable(int numRows, int numColumns)

创建表格,指定 表格行数据 和 表头名称
JTable(Object[][] rowData, Object[] columnNames)

使用表格模型创建表格
JTable(TableModel dm)

JTable 字体 和 网格 颜色设置:

// 设置内容字体
void setFont(Font font)

// 设置字体颜色
void setForeground(Color fg)

// 设置被选中的行前景(被选中时字体的颜色)
void setSelectionForeground(Color selectionForeground)

// 设置被选中的行背景
void setSelectionBackground(Color selectionBackground)

// 设置网格颜色
void setGridColor(Color gridColor)

// 设置是否显示网格
void setShowGrid(boolean showGrid)

// 水平方向网格线是否显示
void setShowHorizontalLines(boolean showHorizontalLines)

// 竖直方向网格线是否显示
void setShowVerticalLines(boolean showVerticalLines)
JTable 表头 设置:

// 获取表头
JTableHeader jTableHeader = jTable.getTableHeader();

// 设置表头名称字体样式
jTableHeader.setFont(Font font);

// 设置表头名称字体颜色
jTableHeader.setForeground(Color fg);

// 设置用户是否可以通过在头间拖动来调整各列的大小。
jTableHeader.setResizingAllowed(boolean resizingAllowed);

// 设置用户是否可以拖动列头,以重新排序各列。
jTableHeader.setReorderingAllowed(boolean reorderingAllowed);

JTable 行列 相关设置:

// 设置所有行的行高
void setRowHeight(int rowHeight)

// 设置指定行的行高
void setRowHeight(int row, int rowHeight)

/**

  • 设置当手动改变某列列宽时,其他列的列宽自动调整模式,可选值:
  • JTable.AUTO_RESIZE_ALL_COLUMNS 在所有的调整大小操作中,按比例调整所有的列。
    
  • JTable.AUTO_RESIZE_LAST_COLUMN 在所有的调整大小操作中,只对最后一列进行调整。
    
  • JTable.AUTO_RESIZE_NEXT_COLUMN 在 UI 中调整了一个列时,对其下一列进行相反方向的调整。
    
  • JTable.AUTO_RESIZE_OFF 不自动调整列的宽度;使用滚动条。
    
  • JTable.AUTO_RESIZE_SUBSEQUENT_COLUMNS 在 UI 调整中,更改后续列以保持总宽度不变;此为默认行为。
    

*/
void setAutoResizeMode(int mode)

/*

  • 调整列宽
    */
    // 先获取到某列
    TableColumn tableColumn = jTable.getColumnModel().getColumn(int columnIndex);

// 设置列的宽度、首选宽度、最小宽度、最大宽度
tableColumn.setWidth(int width);
tableColumn.setPreferredWidth(int preferredWidth);
tableColumn.setMinWidth(int minWidth);
tableColumn.setMaxWidth(int maxWidth);

// 调整该列的列宽,以适合其标题单元格的宽度。
tableColumn.sizeWidthToFit();

// 是否允许手动改变该列的列宽
tableColumn.setResizable(boolean isResizable);

// 设置该列的表头名称
tableColumn.setHeaderValue(Object headerValue);

数据相关操作:

表格数据的简单设置和获取
// 设置表格中指定单元格的数据
jTable.getModel().setValueAt(Object aValue, int rowIndex, int columnIndex);

// 获取表格中指定单元格的数据
Object value = jTable.getModel().getValueAt(int rowIndex, int columnIndex);

创建带滚动条的表格

  • 效果

创建带滚动条的表格基本步骤:

创建表格
JTable table = new JTable(…);

设置表格相关数据
// 设置滚动面板视口大小(超过该大小的行数据,需要拖动滚动条才能看到)
table.setPreferredScrollableViewportSize(new Dimension(int width, int height));

  • 创建滚动面板,把表格放到滚动面板中
  • 再把滚动面板添加到其他容器中显示

TableModel

TableModel 接口指定了 JTable 用于询问表格式数据模型的方法。TableModel 封装了表格中的各种数据,为表格显示提供数据。上面案例中直接使用行数据和表头创建表格,实际上JTable 内部自动将传入的行数据和表头封装成了 TableModel。

只要数据模型实现了 TableModel 接口,就可以通过以下两行代码设置 JTable 显示该模型:

TableModel myData = new MyTableModel();
JTable table = new JTable(myData);
TableModel 接口中的方法:

/** 返回总行数 */
public int getRowCount();

/** 返回总列数 */
public int getColumnCount();

/** 返回指定列的名称(表头名称) */
public String getColumnName(int columnIndex);

/** 针对列中所有的单元格值,返回最具体的超类。JTable 使用此方法来设置列的默认渲染器和编辑器。 */
public Class getColumnClass(int columnIndex);
  • 判断指定单元格是否可编辑
    如果行和列中的单元格是可编辑的,则返回true。否则,在单元格上调用setValueAt将无效。
    注意:该列是按表视图的显示顺序指定的,而不是按TableModel的列顺序指定的。这是一个重要的区别,因为当用户重新排列表中的列时,视图中给定索引处的列将发生变化。同时,用户的操作永远不会影响模型的列顺序。

    /** 获取指定单元格的值 */
    public Object getValueAt(int rowIndex, int columnIndex);

    /** 设置指定单元格的值 */
    public void setValueAt(Object aValue, int rowIndex, int columnIndex);

    /** 添加表格模型监听器 */
    public void addTableModelListener(TableModelListener l);

    /** 移除表格模型监听器 */
    public void removeTableModelListener(TableModelListener l);
    }

JRE 中常用的已实现 TableModel 接口的类有两个:

(1)javax.swing.table.AbstractTableModel

此抽象类为 TableModel 接口中的大多数方法提供默认实现。它负责管理侦听器,并为生成 TableModelEvents 以及将其调度到侦听器提供方便。要创建一个具体的 TableModel 作为 AbstractTableModel 的子类,只需提供对以下三个方法的实现:

public int getRowCount();
public int getColumnCount();
public Object getValueAt(int row, int column);

(2)javax.swing.table.DefaultTableModel

这是 TableModel 的一个实现,它使用一个 Vector 来存储单元格的值对象,该 Vector 由多个 Vector 组成。DefaultTableModel 还增加了许多方便操作表格数据的方法,例如 支持 添加 和 删除 行列 等操作。

你可能感兴趣的:(Swing)