JFace中的工具条和菜单
前一节中我们简单介绍了一下Action。其实所谓的Action就是一个最常用的事件,举个例子来说,对于一个按钮来说它可以有多个事件,比如按键,焦点,鼠标,等等等等吧,但是实际上在使用程序的时候,我们最关心的,就是按下去这个按钮会发生什么,这个其实就是所谓的Action。如果大家以前做过swing/awt变成的话,应该对Action不会陌生。
在JFace里面,一个Action可以对应多个GUI对象,这些对象就是所谓的Contribution Item。比如我们在一般程序里面很常见的“文件”菜单,下面都会有“新建”,“保存”等等。同时我们可以在工具条上放置相应的按钮,那么这些都是有相同的功能,在JFace里面我们可以只写一个Action,然后把它映射到不同的ContributionItem去,而不必为每个部件都写一串处理事件。
我们下面还是通过一个简单的例子来说明,在JFace中怎么使用菜单和工具条这两种最基本也是最有用的Contribution Item。
我们这个程序写得很傻,就是一个光秃秃的窗口上做了一个菜单和工具条按钮,功能也只有一个,就是每次点一下,就弹出一个输入框来问你名字是什么,然后显示一个Hello, xxx之类的。
首先我们还是来写一个Action类:
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类:
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里面就可以了。就象前面代码中的:
至于工具条就更简单了,创建一个ToolBarManager然后直接add对应的Action就可以了。
添加图标
如果菜单只是文字还没有什么,如果你的工具条都是文字是不是会显得干巴巴的?其实只要我们为Action设置ImageDescriptor就可以了,比如你可以自己画一个图标保存到Action的包下面(我画了一个hi.gif),然后把Action的构造函数改写成这样:
super ();
this .shell = shell;
this .setText( " Say&Hi@Ctrl+H " );
this .setImageDescriptor(ImageDescriptor.createFromFile( this .getClass(),
" hi.gif " ));
}
大家注意最后一句话,就是为action设置图标的。然后再运行一下就会发现菜单和工具栏都有图标了。
结束语
这一系列的文章陆陆续续写到今天,也就写完了。回头看一下,虽然内容都很浅显,不过我觉得在swt和JFace中文资料缺乏的今天,可能也可以给大家带来一些启迪。今后我还会写一些eclipse平台开发的文章,大家可以登陆到我的blog(http://blog.csdn.net/jayliu)查看。
另外大家也可以登陆到在中国Eclipse社区(http://www.eclipseworld.org),在那里你也可以找到很多的帮助和支持,当然,你也可以在那里找到我。