关于Java Table的使用
TableViewer表格类是JFace组件中重要且典型的一个组件,其中涉及了JFace的众多重要概念:内容器、标签器、过滤器、排序器和修 改器,这些概念对后面JFace组件特别是TreeViewer的学习非常重要。从本章也可以体会到JFace非常突出的面向对象特性。14.1 概 述JFace是SWT的扩展,它提供了一组功能强大的界面组件,其中包含表格、树、列表、对话框、向
TableViewer表格类是JFace组件中重要且典型的一个组件,其中涉及了JFace的众多重要概念:内容器、标签器、过滤器、排序器和修 改器,这些概念对后面JFace组件特别是TreeViewer的学习非常重要。从本章也可以体会到JFace非常突出的面向对象特性。
14.1
JFace是SWT的扩展,它提供了一组功能强大的界面组件,其中包含表格、树、列表、对话框、向导对话框等,从本章之后就开始专门来介绍这些JFace组件。
表格是一种在软件系统很常见的数据表现形式,特别是基于数据库的应用系统,表格更是不可缺少的界面组件。SWT的表格组件(Table类)前面已经 介绍过了,但在实际项目开发中一般还是用JFace的表格组件TableViewer比较多。TableViewer组件是在SWT的Table组件基础 上采用MVC模式扩展而来的,但Table并非TableViewer的父类,从图14.1两个类的谱系图就可以看出这两个类不属于同一族系。
从下面的TableViewer类源代码可以看到,TableViewer把Table作为一个实例变量,从而实现了对Table功能的扩展。
public class TableViewer extends StructuredViewer { private TableViewerImpl tableViewerImpl; private Table table; //把Table类作为一个实例变量 private TableEditor tableEditor; …… } |
本章就如何使用表格组件TableViewer类来展开讲解,并通过一步步地创建一个完整的表格应用实例来串起表格的知识点,实例的最后界面如图14.2所示。
图14.1 谱系图 |
图14.2 本章实例的最后界面 |
14.2
作为起步,本节将演示如何创建一个TableViewer对象,如何用TableViewer来显示数据记录,实例运行效果如图14.3所示。
图14.3 TableViewer效果图 |
14.2.1
本实例用TableViewer来显示一个数据表中的3条记录,每一条记录对应某一个人的基本资料,记录有5个字段:ID号(数值型)、姓名(字符型)、性别(布尔型)、年龄(数值型)和记录建立时间(日期型)。
如何在程序中体现和操作这些数据记录呢?在过去,像ASP、PHP这类面向过程的编程模式,人们习惯了这样操作数据:从数据库中读取数据,并不对数据做任何封装,直接将数据一条条地显示在表格中。
现在用Java这种面向对象的编程语言,应该用更规范的方式来操作数据:将数据库中的记录看作一个数据对象,用一个类来表示它,数据表的字段写成类的实例变量,这样的类在Java中叫做实体类(或称数据类)。EJB和Hibernate的数据操作方式都是这样的。
数据库与表格显示之间加上了实体类,如此一来,以前的“数据表→表格显示”方式就分成了两个步骤“数据库→实体类→表格显示”。有些习惯了以前编程方式的人也许会觉得多了一个步骤太麻烦,但其实这种方式很有好处:
表格显示的代码不再和数据库表相关。例如,将数据库由Oracle移植到MySQL时就不需要更改“数据库→实体类”这个环节的代码。
零散的字段变量统一在一个类中,程序代码结构更紧凑、清晰,有利于今后代码的维护。不要小看维护问题,很多系统做好后不敢再改,害怕改动后会牵涉到其他模块,其中原因之一就是代码结构太乱、编程不规范所致。
将数据封装在一个实体类中,在数据传递时方便许多,可以将实体类作为一个参数在方法与方法之间来回传递。
14.2.2
下面依照表中的字段来创建一个相应的实体类,类名为PeopleEntity,代码如下所示。
//------------- 文件名:PeopleEntity.java -------------- // 本类包含5个不同数据类型的变量,分别对应数据库表中的5个字段。变量为private型,即只能 // 由类的内部代码访问,外界只能通过这些变量相应的Setter/Getter方法来访问它们 public class PeopleEntity { private Long id; //唯一识别码,在数据库里常为自动递增的ID列 private String name; //姓名 private boolean sex; //性别 true男,flase女 private int age; //年龄 private Date createDate; //记录的建立日期。Date类型是java.util.Date,而不是java.sql.Date //以下代码为字段各自的Setter/Getter方法。参考第3.5.2节,这些方法在Eclipse可自动生成 public Long getId() { return id;} public void setId(Long long1) {id = long1;} public String getName() {return name;} public void setName(String string) {name = string;} public boolean isSex() { return sex;} public void setSex(boolean sex) { this.sex = sex; } public int getAge() {return age;} public void setAge(int i) {age = i;} public Date getCreateDate() {return createDate;} public void setCreateDate(Date date) {createDate = date;} } |
14.2.3
由于数据操作是分两步走:“数据库→实体类→表格显示”,实体类隔离了代码对数据库的依赖,所以“数据库→实体类”这一步就不再讲解,这部分的代码 与JFace组件的使用无关紧要,也不会影响表格组件的讲解。关于TableViewer和数据库结合使用方面的内容,在后面“插件项目实战”中会有详细 示例。
那么如何生成实体类的对象呢?因为数据记录和实体对象相对应,新创建的实体对象就相当于一个空记录,可以用其set方法一个个地将值设入实体对象中,这样就能得到带有数据的实体对象了。
为了今后便于扩展,将创建实体对象的方法集中在一个类中,这种专门负责创建对象的类又叫对象工厂。此类的代码如下:
//-----------文件名:PeopleFactory.java ---------------- //创建PeopleEntity对象的工厂,创建3个PeopleEntry对象,并装入List集合返回 public class PeopleFactory { public static List getPeoples() { // 工厂的静态方法 List list = new ArrayList(); { // 第1个实体类对象 PeopleEntity o = new PeopleEntity(); o.setId(new Long(1));// id字段的类型被定义成了Long,所以要转化一下 o.setName("陈刚"); o.setSex(true); o.setAge(28); o.setCreateDate(new Date()); // 当前日期 list.add(o); } { // 第2个实体类对象 PeopleEntity o = new PeopleEntity(); o.setId(2L); // 利用JDK5.0的自动装箱功能,省了long到Long对象的转化 o.setName("周阅"); o.setSex(false); o.setAge(18); o.setCreateDate(new Date()); list.add(o); } { // 第3个实体类对象 PeopleEntity o = new PeopleEntity(); o.setId(3L); o.setName("陈常恩"); o.setSex(true); o.setAge(27); o.setCreateDate(new Date()); list.add(o); } return list; } } |
程序说明:
在实际应用中,getPeoples方法可由硬性生成PeopleEntity对象,改为从数据库中取出数据后生成PeopleEntity对象。
这里的List不是SWT组件的List,而是Java的集合类java.util.List。根据实际开发情况也可以用数组或Set、Map等代替List。
List是接口,而ArrayList是实际用的类。由于其后代码是基于List接口编写的,所以换用其他List接口的实现类,如Vector、 LinkedList等,而不必修改其后的代码。面向接口编程,尽量让定义类型(如List)比实际类型(如ArrayList)更宽泛些,有利于以后的 修改维护。
这里new ArrayList()使用了JDK5.0的泛型功能,关于泛型可参阅www.chengang.com.cn
在数据库编程中,Java集合类起着重要作用。一定要很熟悉各集合类在特性上的差别,这样才能根据实际开发情况作出适当的选择(集合类的详细资料可查阅Java基础书籍)。
14.2.4
在得到由List装载的包含数据信息的实体类对象后,接下来就是使用TableViewer来显示这些数据,实现过程一般要经过如下步骤:
第一步:创建一个TableViewer对象,并在构造函数中用式样设置好表格的外观,这与其他SWT组件的用法一样。
第二步:通过表格内含的Table对象设置布局方式,一般都使用TableViewer的专用布局管理器TableLayout。该布局方式将用来管理表格内的其他组件(如TableColumn表格列)。
第三步:用TableColumn类创建表格列。
第四步:设置内容器和标签器。内容器和标签器是JFace组件中的重要概念,它们分别是IStructuredContentProvid
第五步:用TableViewer的setInput方法将数据输入到表格。就像人的嘴巴,setInput就是TableViewer的嘴巴。
图14.4是TableViewer整个数据流程的示意图。
图14.4 TableViewer数据流程示意图 |
程序代码如下(内容器和标签器写成两个单独的类):
//-------------文件名:TableViewer1.java------------------- shell.setLayout(new FillLayout()); // 第一步:创建一个TableViewer对象。式样:MULTI可多选、H_SCROLL有水平滚动条、V_SCROLL // 有垂直滚动条、BORDER有边框、FULL_SELECTION整行选择 TableViewer tv=new TableViewer(shell, SWT.MULTI |SWT.BORDER |SWT.FULL_SELECTION); // 第二步:通过表格内含的Table对象设置布局方式 Table table = tv.getTable(); table.setHeaderVisible(true); // 显示表头 table.setLinesVisible(true); // 显示表格线 TableLayout layout = new TableLayout(); // 专用于表格的布局 table.setLayout(layout); // 第三步:用TableColumn类创建表格列 layout.addColumnData(new ColumnWeightData(13));// ID列宽13像素 new TableColumn(table, SWT.NONE).setText("ID号"); layout.addColumnData(new ColumnWeightData(40)); new TableColumn(table, SWT.NONE).setText("姓名"); layout.addColumnData(new ColumnWeightData(20)); new TableColumn(table, SWT.NONE).setText("性别"); layout.addColumnData(new ColumnWeightData(20)); new TableColumn(table, SWT.NONE).setText("年龄"); layout.addColumnData(new ColumnWeightData(60)); new TableColumn(table, SWT.NONE).setText("记录建立时间"); // 第四步:设置内容器和标签器 tv.setContentProvider(new TableViewerContentProvid |
//-------------文件名:TableViewerContentProvid |
//-------------文件名:TableViewerLabelProvider |
程序说明:TableViewer的setInput方法的参数类型是Object,所以它可以接受任何类型的参数,因此在内容器中要将参数转换过 来,如(List) element。但如果setInput不是List类型的参数,程序就会出错,所以最好用element instanceof List来作一下类型判断会比较稳妥,在SWT/JFace编程中很多BUG都出在这种地方。当然,本例的setInput参数定的就是List类型,不 用instanceof判断直接类型转换也没什么问题。
14.3
如何让TableViewer的每一行响应鼠标的双击或单击事件呢?又如何取得被选择中的记录数据呢?本节将解决这个问题。本节实例的效果如图14.5所示,双击表格中的某条记录时弹出一个提示框,框中的文字信息显示该记录的人名。
图14.5 鼠标响应的效果图 |
本节实例在14.2节的代码基础上修改完成(完整代码见配书光盘的TableViewer2.java文件),具体如下。
在tv.setInput(data)一句之后,添加一个自定义方法addListener(tv),在此方法中给TableViewer添加监听器。addListener方法的代码如下:
private void addListener(TableViewer tv) { // 鼠标双击事件监听 tv.addDoubleClickListener(new IDoubleClickListener() { public void doubleClick(DoubleClickEvent event) { //得到表格的选择对象,里面封装了表格中被选择的记录信息 IStructuredSelection selection = (IStructuredSelection) event.getSelection(); // 得到所选择的第一条实体对象(表格可以有多选),并进行类型转换 PeopleEntity o = (PeopleEntity) selection.getFirstElement(); // 弹出一个提示框 MessageDialog.openInformation(null, "提示", o.getName()); } }); // 选择事件(单击)监听 tv.addSelectionChangedListe |
14.4
本节来给表格加上如图14.6所示的右键菜单。本节实例在前两节的代码基础上修改完成(完整代码见配书光盘的TableViewer3.java文件)。
图14.6 右键菜单的效果图 |
14.4.1
SWT中菜单是Menu类,本书在前面章节中已经介绍过Menu类的使用,在第11章中菜单项用MenuItem类来实现。但在实际项目中,同一种 功能会有多种表现形式,例如Eclipse中的“新建”功能,它会分别出现在主菜单、主工具栏、右键菜单里。如果都是用MenuItem来实现,就需要写 3份类似的代码,以后也要维护3份代码。当然也可以将事件处理写成外部类来共享代码,但名称、图像以及一些其他的信息写成外部类来共享则不太方便。
JFace包中已经对以上问题提供了解决方案,JFace提供了一个Action类,它将名称、图像、动作处理程序等集成在其中,这样就可以共享这些Action来形成菜单项、工具栏按钮等。
当然在底层最后用于Menu的还是MenuItem对象,将Action转化成MenuItem是由MenuManager(菜单管理器)来完成 的。MenuManager简化了菜单的创建,一旦生成了MenuManager对象,就可以通用于菜单栏、弹出菜单、工具栏下拉菜单。
另外,Action写成一个个的类会很零乱,JFace又提供了一个ActionGroup类用于统一管理Action,然后让外界程序通过ActionGroup来访问Action。当然,并非一定要使用ActionGroup类来管理Action,只是用它会更好。
14.4.2
以下代码演示了如何创建Action、ActionGroup,以及如何使用MenuManager。
//--------文件名:MyActionGroup.java---------- public class MyActionGroup extends ActionGroup { private TableViewer tv; // 在Action要使用到TableViewer对象,所以通过构造函数把它传进来 public MyActionGroup(TableViewer tv) { this.tv = tv; } // 生成菜单Menu,并将两个Action传入 public void fillContextMenu(IMenuManager mgr) { // 加入两个Action对象到菜单管理器 MenuManager menuManager = (MenuManager) mgr; menuManager.add(new OpenAction()); menuManager.add(new RefreshAction()); // 生成Menu并挂在表格table上。menu和table两个对象互为对方的参数 Table table = tv.getTable(); Menu menu = menuManager.createContextMenu(table); table.setMenu(menu); } // “打开”的Action类 private class OpenAction extends Action { public OpenAction() {setText("打开");} public void run() {// 继承自Action的方法,动作代码写在此方法中 IStructuredSelection selection = (IStructuredSelection) tv.getSelection(); PeopleEntity o = (PeopleEntity) selection.getFirstElement(); if (o == null) MessageDialog.openInformation(null, null, "请先选择记录"); else MessageDialog.openInformation(null, null, o.getName()); } } // “刷新”的Action类 private class RefreshAction extends Action { public RefreshAction() {setText("刷新");} public void run() { tv.refresh(); //表格的刷新方法,界面会重新读取数据并显示 } } } |
14.4.3
MyActionGroup类封装了Action以及Action和菜单Menu之间的交互代码。最后,只需将以下代码加入到shell.open()语句之前即可。
//生成一个ActionGroup对象,并调用fillContextMenu方法将按钮注入到菜单对象中 MyActionGroup actionGroup = new MyActionGroup(tv); |
程序说明:图14.7说明了在程序中是如何创建右键菜单的,在主程序生成一个MenuManager对象传给ActionGroup对象,然后再通 过ActionGroup内部的createContextMenu方法生成一个菜单对象Menu,最后用Menu的add()方法将Action加入。
图14.7 程序分析图 |
14.5
本节实例将实现表格的单击表头排序功能(以ID、姓名两字段的排序为例),本节实例在前面几节的代码基础上修改完成(完整代码见配书光盘的TableViewer4.java文件)。
14.5.1
TableViewer是根据排序器ViewerSorter中的设置来进行排序的,所以编写ViewerSorter类是排序的关键。编写排序器的代码如下:
//------文件名:MySorter.java----------- public class MySorter extends ViewerSorter { // 每列对应一个不同的常量,正数表示要升序、相反数表示要降序 private static final int ID = 1; private static final int NAME = 2; //给外界使用排序器对象 public static final MySorter ID_ASC=new MySorter(ID); public static final MySorter ID_DESC=new MySorter(-ID); public static final MySorter NAME_ASC=new MySorter(NAME); public static final MySorter NAME_DESC=new MySorter(-NAME); // 当前所要排序的列,取自上面的ID、NAME两值或其相反数 private int sortType; // 构造函数用private,表示不能在外部创建MySorter对象 private MySorter(int sortType) { this.sortType = sortType; } // 最关键的比较方法compare,改写自ViewerSorter。方法返回值是一个int值:正数则 //obj1移到obj2之前;零则obj1和obj2的位置不动;负数则obj1移到obj2之后 public int compare(Viewer viewer, Object obj1, Object obj2) { // 传入两条记录(实体类),然后依列给出它们的先后顺序 PeopleEntity o1 = (PeopleEntity) obj1; PeopleEntity o2 = (PeopleEntity) obj2; switch (sortType) { case ID: { Long l1 = o1.getId(); Long l2 = o2.getId(); // Long的compareTo方法返回值有三个可能值1,0,-1: |
程序说明:排序器的代码虽多,但要点就两个。
q
排序的算法由MySorter类的compare方法负责,它实际调用的是JDK中同类型对象之间进行比较的compareTo方法,TableViewer则根据MySorter返回的int值来进行记录的排序
14.5.2
表格列是TableColumn对象,把原来新增ID列和姓名列的4句代码修改如下:
// layout.addColumnData(new ColumnWeightData(13));// ID列宽13像素 // new TableColumn(table, SWT.NONE).setText("ID号"); // layout.addColumnData(new ColumnWeightData(40)); // new TableColumn(table, SWT.NONE).setText("姓名"); layout.addColumnData(new ColumnWeightData(13)); TableColumn col1 = new TableColumn(table, SWT.NONE); col1.setText("ID号"); col1.addSelectionListener(new SelectionAdapter() { boolean asc = true; // 记录上一次的排序方式,默认为升序 public void widgetSelected(SelectionEvent e) { // asc=true则ID的升序排序器,否则用降序 tv.setSorter(asc ? MySorter.ID_ASC : MySorter.ID_DESC); asc = !asc;// 得到下一次排序方式 } }); layout.addColumnData(new ColumnWeightData(40)); TableColumn col2 = new TableColumn(table, SWT.NONE); col2.setText("姓名"); col2.addSelectionListener(new SelectionAdapter() { boolean asc = true; public void widgetSelected(SelectionEvent e) { tv.setSorter(asc ? MySorter.NAME_ASC : MySorter.NAME_DESC); asc = !asc; } }); |
14.6
如图14.8所示,本节将给表格加上一个工具栏。本节实例在前几节的代码基础上修改完成(完整代码见配书光盘的TableViewer5.java文件)。
图14.8 工具栏效果图 |
和14.4节给表格加上右键菜单的方法相似,也是用ActionGroup、Action类。不同的是,菜单用MenuManager,这里的工具栏则用ToolBarManager。此实例分成如下几步完成。
14.6.1
将图14.8中的按钮都写成一个个的Action类,关于Action类的写法在14.4节已经讲过,只需依样扩充MyActionGroup类中 的Action的个数即可,而刷新按钮则和刷新菜单共用RefreshAction。MyActionGroup的代码修改示意如下:
//------文件名:MyActionGroup.java----------- ……(省略了原来的老代码) private class AddAction extends Action { public AddAction() { setHoverImageDescriptor(getImageDesc("project.gif"));// 正常状态下的图标 setText("增加"); } public void run() { PeopleEntity o = createPeople();// 创建一个新实体对象 tv.add(o);// 增加到表格界面中 List list = (List) tv.getInput(); list.add(o); // 增加到数据模型的List容器中 // ....向数据库增加记录(略) } private PeopleEntity createPeople() {// 创建一个新实体对象 PeopleEntity o = new PeopleEntity(); o.setId(5L); o.setName("新人"); o.setSex(true); o.setAge(15); o.setCreateDate(new Date()); return o; } } private class RemoveAction extends Action { public RemoveAction() { setHoverImageDescriptor(getImageDesc("remove.gif"));// 正常状态下的图标 // 按钮无效状态下的图标。不设也可以,当按钮失效时会自动使正常图片变灰 setDisabledImageDescript |
程序说明:在表格中,界面中显示的数据和setInput(Object input)传入的input对象是分离的。也就是说如果input对象中的记录数据发生改变,要调用表格的tv.refresh()或 tv.update(Object element, String[] properties)才能在界面上也显示新的数据。refresh、update两个更新界面的方法中:前者是全面更新;后者是只更新某一条记录 (element)在界面上的显示,后者的第二个参数甚至还可以指定更新哪几个字段的界面显示,显然后者更新效率要高些。
对于新增记录和删除记录则TableViewer有add和remove方法可用,不过由于前面所说的界面数据和input数据分离,在tv.add、tv.remove之后,勿忘input.add、input.remove。
14.6.2
在上一步创建好ActionGroup中的Action后,接下来就是要在界面中加上工具栏。先要将布局用ViewForm类来调整一 下,ViewForm也是继承自Composite的一个容器。原先表格是建立在Shell之上的,现在要在Shell上再插入一个ViewForm容 器,以它为基座将工具栏和表格创建于其中,如图14.9所示。
将原主程序中的open()方法修改如下,其他代码不变:
shell.setLayout(new FillLayout()); ViewForm viewForm = new ViewForm(shell, SWT.NONE); //布局基座ViewForm viewForm.setLayout(new FillLayout()); final TableViewer tv = new TableViewer(viewForm, SW… //父容器由shell改为viewForm //……和上一节相同的代码(省略) //创建工具栏 ToolBar toolBar = new ToolBar(viewForm, SWT.FLAT); // 创建一个ToolBar容器 ToolBarManager toolBarManager = new ToolBarManager(toolBar); // 创建一个toolBar的管理器 actionGroup.fillActionToolBars(toolBarManager); //将Action通过toolBarManager注入ToolBar中 // 设置表格和工具栏在布局中的位置 viewForm.setContent(tv.getControl()); // 主体:表格 viewForm.setTopLeft(toolBar); // 顶端边缘:工具栏 shell.open(); |
图14.9 布局示意图 |
14.7
带复选框的表格如图14.10所示,它具有如下功能:
单击“全选”按钮时,将表格中的所有记录选中(选中复选框)。
单击“全不选”按钮时,取消所有选择(取消选中复选框)。
单击“删除”按钮时,将所有选中复选框的记录删除。
图14.10 带复选框的表格 |
本节实例在前几节的代码基础上修改完成(完整代码见配书光盘的TableViewer6.java文件)。要完成此实例需要如下几个步骤。
14.7.1
(1)在创建TableViewer对象时多加一个SWT.CHECK式样,表格变为复选框式。复选框式的表格要取得选中的记录,还需要增加一个CheckboxTableViewer对象来辅助表格的使用,因为仅TableViewer对象无法取得选中的记录。
final TableViewer tv = new TableViewer(viewForm, SWT.CHECK | SWT.MULTI | SWT.…… final CheckboxTableViewer ctv = new CheckboxTableViewer(tv.getTable()); |
(2)修改创建MyActionGroup的语句,将CheckboxTableViewer的ctv对象作构造函数的第二个参数传入,因为MyActionGroup中的Action需要用到此对象。
MyActionGroup actionGroup = new MyActionGroup(tv, ctv); |
这一步完成后,因为还没有对MyActionGroup类作相应改动,Eclipse会显示错误。下面开始修改MyActionGroup类。
14.7.2
在原有MyActionGroup类的代码中作如下几处修改:
新增一个用于接受CheckboxTableViewer对象的构造函数。
增加“全选”和“全不选”两个Action类,并相应修改fillActionToolBars方法。
修改“删除”的RemoveAction,改由CheckboxTableViewer来取得选中的记录。因为前几节的程序也用到 RemoveAction,为了兼容,所以RemoveAction原有的处理代码还不能废弃掉。可以加一个表格是否为复选框式样的判断,以决定使用哪种 删除处理代码。
具体代码如下所示:(和原代码相同部分用省略号代替)
public class MyActionGroup extends ActionGroup { private TableViewer tv; private CheckboxTableViewer ctv; //新增的语句 public MyActionGroup(TableViewer v) { this.tv = v; } //新增一个构造函数 public MyActionGroup(TableViewer v, CheckboxTableViewer ctv) { this.tv = v; this.ctv = ctv; } …… |
14.8
前面仅仅是显示表格数据,本节谈谈如何修改数据。本节实例效果如图14.11所示。本节实例在前几节的代码基础上修改完成(完整代码见配书光盘的TableViewer7.java文件)。
图14.11 CellEditor效果图 |
14.8.1
首先在TableViewer主程序前部的变量定义区中创建一个静态公用的字符串数组,它们就是修改“姓名”列时出现在下拉框中的值。
public static String[] NAMES = { "老张", "小红", "陈刚", "周阅", "陈常恩" }; |
接着给表格列添加编辑组件CellEditor,在tv.setInput(data)语句之后,加入如下程序块:
// 定义每一列的别名 tv.setColumnProperties(new String[] { "id", "name", "sex", "age", "createdate" }); // 设置每一列的单元格编辑组件CellEditor CellEditor[] cellEditor = new CellEditor[5]; cellEditor[0] = null; cellEditor[1] = new ComboBoxCellEditor(tv.getTable(), NAMES, SWT.READ_ONLY); cellEditor[2] = new CheckboxCellEditor(tv.getTable()); cellEditor[3] = new TextCellEditor(tv.getTable()); cellEditor[4] = null; tv.setCellEditors(cellEditor); tv.setCellModifier(new MyCellModifier(tv)); // 设置表格的修改器MyCellModifier Text text = (Text) cellEditor[3].getControl();// 设置第4列只能输入数值 text.addVerifyListener(new VerifyListener() { // 以下代码说明参阅第8.4节“文本框”,完全一样 public void verifyText(VerifyEvent e) { String inStr = e.text; if (inStr.length() > 0) { e.doit = NumberUtils.isDigits(inStr); } } }); |
程序说明:表格设置的列别名在修改器MyCellModifier类中要用到。和设置列别名一样,设置列的CellEditor编辑组件也是用数组的方式,其数组序号和列序号一一对应。
14.8.2
修改器MyCellModifier是最重要的一个类,也是最复杂的一个类,编程时一不小心就容易出BUG。其代码如下所示:
//------------- 文件名:MyCellModifier.java -------------- public class MyCellModifier implements ICellModifier { private TableViewer tv; public MyCellModifier(TableViewer tv) { this.tv = tv; } // 判断是否可以修改某条记录的某一字段。这里返回true表示都可以修改 // 参数element是表格记录对象,也就是PeopleEntity对象 // 参数property是列别名。该值不会有CellEditor为null的列,也就是说它不可能为id,createdate public boolean canModify(Object element, String property) { return true; } // 此方法决定当单击单元格出现CellEditor时应该显示什么值。参数说明参考canModify方法 // 每种CellEditor要求返回的数据类型都是各不相同的,类型不对应就会出错 public Object getValue(Object element, String property) { PeopleEntity o = (PeopleEntity) element; if (property.equals("name")) { // ComboBoxCellEditor要求返回姓名在下拉框中的索引值 return getNameIndex(o.getName()); } else if (property.equals("sex")) { // CheckboxCellEditor要求返回当前值对应的布尔值 return o.isSex(); } else if (property.equals("age")) { // TextCellEditor要求返回当前值对应的字符串 return String.valueOf(o.getAge()); } throw new RuntimeException("错误的列别名:" + property); } private int getNameIndex(String name) { for (int i = 0; i < TableViewer7.NAMES.length; i++) { if (TableViewer7.NAMES[i].equals(name)) return i; } return -1; } // 从CellEditor取值得此单元格的值 // 参数element是表格行对象TableItem,其getData()方法可取得PeopleEntity // 参数property是列别名 // 参数value是修改后的新值。每种CellEditor的value的数据类型各不相同 public void modify(Object element, String property, Object value) { TableItem item = (TableItem) element; PeopleEntity o = (PeopleEntity) item.getData(); // 根据新的修改值更新PeopleEntity对象的数据 if (property.equals("name")) { // ComboBoxCellEditor的value是其索引值 Integer comboIndex = (Integer) value; String newName = TableViewer7.NAMES[comboIndex]; o.setName(newName); } else if (property.equals("sex")) { // CheckboxCellEditor的value是布尔值 Boolean newValue = (Boolean) value; o.setSex(newValue); } else if (property.equals("age")) { // TextCellEditor的value就是文本框里的字符 String newValue = (String) value; if (newValue.equals(""))// 如果不修改 return; int newAge = Integer.parseInt(newValue); o.setAge(newAge); } else { throw new RuntimeException("错误的列别名:" + property); } // 更新对象在表格上的界面显示。也可以用tv.refresh()全面更新界面,但太浪费效率 tv.update(o, null); } } |
程序说明:
当单击一个可修改表格列时,首先执行canModify方法来决定是否编辑这条记录,如果它返回true才会接着去执行getValue方法,并通 过getValue方法决定编辑组件的显示值。接着用户在表格上显示的编辑组件里进行值的修改,修改完成后,将修改值传入到modify方法,在此方法中 自己编程把新值更新到表格显示。
在感观上单元格编辑组件似乎是表格的一部分,但实际上它是作为单独组件叠加在表格上的,加上编辑组件种类复杂,所以才要MyCellModifier这样的类来作为编辑组件和表格组件的中间人,进行数据处理和传递。
14.9
14.9.1
建立一个继承自ViewerFilter的类,称之为过滤器类。下面的实例建立了一个过滤器,此过滤器的作用是在表格中只显示姓名叫“陈刚”的记录。
//------------- 文件名:MyFilter.java -------------- public class MyFilter extends ViewerFilter { // 参数viewer在本例中就是TableViewer对象 // 参数parentElement 在本例中是一个包含全部记录的Object数组 // 参数element 当前传入的记录,需要判断是否过滤它 // 返回值=false则此记录(element)不显示。true为显示 public boolean select(Viewer viewer, Object parentElement, Object element) { PeopleEntity o = (PeopleEntity) element; return o.getName().equals("陈刚"); } } |
表格使用过滤器的语句如下所示,也可以把它写入某Action的run方法中:
tv.addFilter(new MyFilter()); //tv是TableViewer对象 |
14.9.2
可以将以下语句写在某个事件代码中,例如写在Action的run方法中。
(1)向下移动,到底后又回到第一行。
Table table = tv.getTable(); int i = table.getSelectionIndex(); //取得当前所选行的序号,如没有则返回-1 table.setSelection(i + 1); //当前选择行移下一行 |
(2)向上移动,到第一行后又回到最末尾一行。
Table table = tv.getTable(); int i = table.getSelectionIndex(); if (i > 0) //是否超过第一行 table.setSelection(i - 1); //向上移 else { int count = table.getItemCount(); //总的行数 table.setSelection(count - 1); } |
14.9.3
如下语句将使第1行第2列的单元格背景色变为红色(要加在tv.setInput()方法后面)。
Table table = tv.getTable(); //tv是一个TableViewer对象 TableItem item = table.getItem(0); //得到第1行 Color color =Display.getDefault().getSystemColor(SWT.COLOR_RED);//红色 item.setBackground(1, color); //设置此行的第2列为红色 table.redraw(); //重画界面 |
14.9.4
用以下语句可以在TableViewer内部为数据记录和TableItem之间的映射创建一个哈希表,这样可以加快TableItem和记录之间的查找速度,这条语句必须加在setInput方法之前。
tv.setUseHashlookup(true);
更多推荐
所有评论(0)