SWT/Jface开发入门指南(十一)

JFace中的工具条和菜单

前一节中我们简单介绍了一下Action。其实所谓的Action就是一个最常用的事件，举个例子来说，对于一个按钮来说它可以有多个事件，比如按键，焦点，鼠标，等等等等吧，但是实际上在使用程序的时候，我们最关心的，就是按下去这个按钮会发生什么，这个其实就是所谓的Action。如果大家以前做过swing/awt变成的话，应该对Action不会陌生。

在JFace里面，一个Action可以对应多个GUI对象，这些对象就是所谓的Contribution Item。比如我们在一般程序里面很常见的“文件”菜单，下面都会有“新建”，“保存”等等。同时我们可以在工具条上放置相应的按钮，那么这些都是有相同的功能，在JFace里面我们可以只写一个Action，然后把它映射到不同的ContributionItem去，而不必为每个部件都写一串处理事件。

我们下面还是通过一个简单的例子来说明，在JFace中怎么使用菜单和工具条这两种最基本也是最有用的Contribution Item。

我们这个程序写得很傻，就是一个光秃秃的窗口上做了一个菜单和工具条按钮，功能也只有一个，就是每次点一下，就弹出一个输入框来问你名字是什么，然后显示一个Hello, xxx之类的。

首先我们还是来写一个Action类：

 1 
 2  public   class  SayHiAction  extends  Action {
 3       private  Shell shell;
 4 
 5       public  SayHiAction(Shell shell) {
 6           super ();
 7           this .shell  =  shell;
 8           this .setText( " Say&Hi@Ctrl+H " );
 9      }
10 
11      @Override
12       public   void  run() {
13          InputDialog input  =   new  InputDialog(shell,  " Input your name " ,
14                   " Please input your name here: " ,  null ,  null );
15           if  (input.open()  ==  Window.OK) {
16              MessageDialog.openInformation(shell,  " Hello " ,  " Hello,  "
17                       +  input.getValue()  +   " ! " );
18          }
19 
20      }
21 
22  }
23 

代码段 17

这只是一个很简单的Action类，没有太多可说的。

然后我们创建一个ApplicationWindow类：

 1 
 2  public   class  Hiyou  extends  ApplicationWindow {
 3 
 4       private  SayHiAction hiaction;
 5       public  Hiyou(Shell parentShell) {
 6           super (parentShell);
 7          hiaction = new  SayHiAction(getShell());
 8          addMenuBar();
 9          addToolBar(SWT.FLAT  |  SWT.WRAP);
10      }
11 
12      @Override
13       protected  ToolBarManager createToolBarManager( int  style) {
14          ToolBarManager toolbar = new  ToolBarManager();
15          toolbar.add(hiaction);
16           return  toolbar;
17      }
18 
19      @Override
20       protected  MenuManager createMenuManager() {
21          MenuManager menubar = new  MenuManager();
22          MenuManager fileMenu = new  MenuManager( " &File " );
23          fileMenu.add(hiaction);
24          menubar.add(fileMenu);
25           return  menubar;
26      }
27 
28       /**
29       *  @param  args
30        */
31       public   static   void  main(String[] args) {
32          Hiyou window = new  Hiyou( null );
33          window.setBlockOnOpen( true );
34          window.open();
35          Display.getCurrent().dispose();
36      }
37 
38  }
39 

 

代码段 18

大家可能已经注意到了，在这里面我们重载了createMenuManager和createToolBarManager两个方法，它们的用途就和名字一样，一个是用来创建菜单的，一个是用来创建工具条的。重载了这两个方法以后，通过在构造函数中调用addMenuBar和addToolBar让工具条和菜单显示出来。

这里值得一提的是MenuManager和ToolBarManager类，如果大家翻一下API文档的话会发现它们都是所谓的contribution manager（实现了IConntributionManager接口），你可以通过这些contribution manager来实现对特定组件的管理（添加删除等等）。

具体到菜单的创建，看了我们上面的代码就很明白了，就直接调用相应MenuManager的add方法把action添加上就可以了。JFace会自动找到这个Action的getText方法设置菜单的文字。如果是有好几层菜单，那么只要在重新new一个MenuManager添加到已有的MenuManager里面就可以了。就象前面代码中的：

menubar.add(fileMenu);

至于工具条就更简单了，创建一个ToolBarManager然后直接add对应的Action就可以了。

添加图标

如果菜单只是文字还没有什么，如果你的工具条都是文字是不是会显得干巴巴的？其实只要我们为Action设置ImageDescriptor就可以了，比如你可以自己画一个图标保存到Action的包下面（我画了一个hi.gif），然后把Action的构造函数改写成这样：

public  SayHiAction(Shell shell) {
         super ();
         this .shell  =  shell;
         this .setText( " Say&Hi@Ctrl+H " );
         this .setImageDescriptor(ImageDescriptor.createFromFile( this .getClass(),
                 " hi.gif " ));
    }

大家注意最后一句话，就是为action设置图标的。然后再运行一下就会发现菜单和工具栏都有图标了。

在这里给一个社区做个广告，大家可以登陆到在中国eclipse社区（http://www.eclipseworld.org），在那里你也可以找到很多的帮助和支持，当然，你也可以在那里找到我。