关于JFace中的向导式对话框(WizardDialog类)

向导式对话框是一种非常友好的界面,它能够引导用户一步步的输入信息.Eclipse的"新建项目",就是这样的向导式对话框.

在Eclipse中向导式对话框的开发是很简单的,它由WizardDialog类来创建向导式对话框.

WizardDialog的继承关系图:

当然仅仅有WizardDialog还是不够的,还需要有Wizard类,WizardPage类来辅助使用.

向导式对话框中每一步显示的页面由WizardPage类负责创建,Wizard类则负责管理WizardPage页面.

WizardDialog最简单,它和InputDialog等的使用相同,所以在向导式对话框的创建中,Wizard和Wizardpage的编程才是重点.

WizardDialog,Wizard,WizardPage三者的关系图如下:

通过一个例子了解:如何创建向导式的对话框,如何给向导式的对话框设置初始值.

如何对值做验证,如何取得向导式对话框中的值,实际开发中也无非就是这些内容,只不过界面组件更多了一些罢了.

向导式对话框使用的时的注意事项

向导式对话框在单击"下一步","上一步"按钮时都会执行MyWizard类的canFinish方法,因此在写

这种方法的时候要注意保证程序的执行效率.

向导式对话框实例:

实现一个简单的向导式对话框,此对话框用于手机用户的资料.它有两个页面,第一个页面收集姓名和Email,第二页面收集学校.最后单击"完成"按钮结束向导后,输出各页面收集到的信息.

如何创建向导式对话框:如何给向导式对话框设初始值:如何对值做验证;如何取得向导式对话框中的值.实际开发中也无非是这些内容.只不过界面组件更多一些罢了.

实例的代码如下:

(1)主程序中对WizardDialog的使用.将Wizard作为参数传给WizardDialog.代码如下:

WizardDialog1.java

 import org.eclipse.jface.wizard.WizardDialog;
 import org.eclipse.swt.widgets.Display;
 import org.eclipse.swt.widgets.Shell;

 public class WizardDialog1 {
     public static void main(String[] args) {
         Display display = Display.getDefault();
         Shell shell = new Shell(display);

         WizardDialog dialog = new WizardDialog(shell, new MyWizard());
         dialog.setPageSize(-1, 60); // dialog大小,-1是指让宽度自动调整
         dialog.open();

         display.dispose();
     }
 }

(2)WizardDialog用到的MyWizard类的代码如下:

MyWizard类主要是改写父类Wizard的3个方法:addPages.canFinish和performFinish.

在addPages方法中加入页面和为页面设置初始值:在canFinish方法中判断"完成"按钮是否可用,在performFinish方法中编写退出向导时候处理程序.

MyWizard.java

 import org.eclipse.jface.wizard.Wizard;

 public class MyWizard extends Wizard {
     // 把两页面对象定义成实例变量，使其他方法能访问得到
     private NamePage namePage;// 页面一，继承自WizardPage类
     private SchoolPage schoolPage;// 页面二，继承自WizardPage类

     // 在此方法将两页面加入并设置初值
     public void addPages() {
         // 创建页面对象，并设置页面的名称
         namePage = new NamePage("namePage");
         schoolPage = new SchoolPage("schoolPage");
         // 设置页面的初始值
         namePage.setName("陈刚");
         namePage.setEmail("glchengang@yeah.net");
         schoolPage.setSchool("广西师范大学");
         // 加入两页面，加入的顺序就是界面上显示的顺序
         addPage(namePage);
         addPage(schoolPage);
     }

     // 由此方法判断“完成”按钮何时有效。返回true则有效，false无效
     public boolean canFinish() {
         System.out.println("aa");
         // 设置成：当还没到最后一页时“完成”按钮无效
         if (this.getContainer().getCurrentPage() != schoolPage)
             return false;
         return super.canFinish();
     }

     // 当单击“完成”按钮退出向导时，将执行此方法
     public boolean performFinish() {
         // 取出各页面的值，并打印输出
         System.out.println(namePage.getName());
         System.out.println(namePage.getEmail());
         System.out.println(schoolPage.getSchool());
         return true;
     }
 }

程序说明:

向导式对话框在单击"下一步","上一步"按钮时都会执行canFinish方法来重置底部按钮的有效状态,因此canFinish方法中的代码的执行效率不要太低.

(3)创建两个继承自WizardPage类:NamePage和SchoolPage.在这两个类中创建页面上的界面组件,添加组件的设值和取值方法.NamePage页的代码如下,里面 有多次用到了Apache的Common软件包:

NamePage.java

 import org.apache.commons.lang.StringUtils;
 import org.apache.commons.validator.EmailValidator;
 import org.eclipse.jface.wizard.WizardPage;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.events.ModifyEvent;
 import org.eclipse.swt.events.ModifyListener;
 import org.eclipse.swt.layout.GridData;
 import org.eclipse.swt.layout.GridLayout;
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.swt.widgets.Text;

 public class NamePage extends WizardPage {
     private String name;
     private String email;
     private Text nameText;
     private Text emailText;

     // 必须继承父类的构造函数
     protected NamePage(String pageName) {
         super(pageName);
     }

     // 改写自父类的方法，在此方法中构建页面上的界面组件。注意不要在传入参数parent基础直接创建界面元素，而应在一个新面板topComp上创建
     public void createControl(Composite parent) {
         // 每页的提示信息
         setTitle("用户信息");
         setMessage("请输入您的姓名及Email", INFORMATION);
         // 创建一个页面组件的底层面板，并使用GridLayout布局
         Composite topComp = new Composite(parent, SWT.NULL);
         topComp.setLayout(new GridLayout());
         // 创建“姓名”文本框
         nameText = new Text(topComp, SWT.BORDER);
         nameText.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
         // 将null转化成""，等效于 name== null ? "" : name
         nameText.setText(StringUtils.defaultString(name));
         // 创建“Email”文本框
         emailText = new Text(topComp, SWT.BORDER);
         emailText.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
         emailText.setText(StringUtils.defaultString(email));
         // 给两文本框加入监听器
         MyModifyListener listener = new MyModifyListener();
         nameText.addModifyListener(listener);
         emailText.addModifyListener(listener);
         // 必须要的一行
         setControl(topComp);
     }

     // 此监听器，每次文本框里的文本变动都会触发，触发频度较大
     private class MyModifyListener implements ModifyListener {
         public void modifyText(ModifyEvent e) {
             setPageComplete(false); // 先使“完成”和“下一步”两按钮无效
             // 用Apache Commons Lang的StringUtils可以检查出全角空格
             name = nameText.getText().trim();// 设回实例变量name
             if (StringUtils.isBlank(name)) {
                 setErrorMessage("姓名不能为空"); // 提示错误信息
                 return;
             }
             // 用了Apache Commons Validator的 EmailValidator来检查Email写法的合法性
             EmailValidator validator = EmailValidator.getInstance();
             email = emailText.getText().trim();// 设回实例变量email
             if (!validator.isValid(email)) {
                 setErrorMessage("Email的格式错误");
                 return;
             }
             // 前面的检查都通过后......
             setErrorMessage(null); // 消除对话框上的出错提示
             setPageComplete(true); // 使“完成”和“下一步”两按钮可用
         }
     }

     // --------相应的Setter/Getter方法 ---------------
     public String getName() {
         return name;
     }

     public void setName(String string) {
         name = string;
     }

     public String getEmail() {
         return email;
     }

     public void setEmail(String string) {
         email = string;
     }
 }

程序说明:"不要重新发明轮子"是软件界的一句著名的俗语,Apache提供了很多所需的软件包,而且都经过了严格的测试和实践检验的,我们有什么理由自己再去写一遍重复的代码呢?示例中的EmailValidator,StringUtils都是Apache的Common工具集中的类,前者是Validator包的,后者是Lang包的.其中,Validator包还需要正规表达式的软件包,ORO的支持.

第二个页面SchoolPage.java的代码和前面的NamePage类似:

SchoolPage.java

 import org.apache.commons.lang.StringUtils;
 import org.eclipse.jface.wizard.WizardPage;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.events.ModifyEvent;
 import org.eclipse.swt.events.ModifyListener;
 import org.eclipse.swt.layout.GridData;
 import org.eclipse.swt.layout.GridLayout;
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.swt.widgets.Text;

 public class SchoolPage extends WizardPage {
     private String school;
     private Text schoolText;

     protected SchoolPage(String pageName) {
         super(pageName);
     }

     public void createControl(Composite parent) {
         // 每页的提示信息
         setTitle("用户信息");
         setMessage("请输入您的学校的名称", INFORMATION);
         // 创建一个组件的底层面板，并使用GridLayout布局
         Composite topComp = new Composite(parent, SWT.NULL);
         topComp.setLayout(new GridLayout());
         // 创建“学校”文本框
         schoolText = new Text(topComp, SWT.BORDER);
         schoolText.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
         schoolText.setText(StringUtils.defaultString(school));
         schoolText.addModifyListener(new MyModifyListener());
         this.setControl(topComp);// 必须要的一行
     }

     // 注释说明请参数NamePage页的监听器，两者现实相似。
     private class MyModifyListener implements ModifyListener {
         public void modifyText(ModifyEvent e) {
             setPageComplete(false);
             school = schoolText.getText().trim();
             if (StringUtils.isBlank(school)) {
                 setErrorMessage("学校名不能为空");
                 return;
             }
             setErrorMessage(null);
             setPageComplete(true);
         }
     }

     // --------相应的Setter/Getter方法 ---------------
     public String getSchool() {
         return school;
     }

     public void setSchool(String string) {
         school = string;
     }
 }

运行结果如下: