Eclipse插件开发系列

class=\"com.glchengang.SampleAction\" tooltip=\"Hello，Eclipse world\"

menubarPath=\"sampleMenu/sampleGroup\" toolbarPath=\"sampleGroup\"

id=\"com.glchengang.SampleAction\"> label=\"样本操作２\" icon=\"icons/sample.gif\"

class=\"com.glchengang.SampleAction\" tooltip=\"Hello，Eclipse world２\"

menubarPath=\"sampleMenu/sampleGroup2\" toolbarPath=\"sampleGroup2\"

id=\"com.glchengang.SampleAction2\">

说明：

a) requires域中定义了该插件所要使用的依赖插件,随着开发的不断深入,这里将会填加更多的引用,现在两项就够了

b) 在extension中说明了要们要扩展org.eclipse.ui. actionSets扩展点, …..表示一个action组(按钮、菜单)。还有其它类型的扩展点，如org.eclipse.ui.views是视图的扩展点，org.eclipse.ui.editors是编辑器的扩展点，各种扩展点在eclipse的帮助中有详细的说明。label是显示的名称。id是唯一标识符，只要保证在plugin.xml文件不存在重复的id就行了，这里建议以包路径和类名的组合来做为id。 c)

d) ....表示按钮。Icon是图片的路径，绝对路径是什么大家实际对照就知道了，如果eclipse找不到这个图片，默认是一个红色实心小框。Class是这个按钮所对应的类，注意把包名写全，这样比较规范些。menubarPath表示把这个action做成一个菜单放在上前

e) 各详细的plugin.xml大家可以参考eclipse自带的帮助文件，这里仅做一个入门性的说明。

六、按钮前面一章所说的方法运行插件（运行之前注意将原来那个向导做的myplugin项目关闭掉，关闭方法：鼠标右键点击此项目－＞弹出菜单中选择关闭项目）。插件效果如下图

参考文档

http://bsd.huangdong.com/dev/eclipseplugin/startup.html

作者相关文章：

• Eclipse插件开发系列（４）：对话框Dialog(原作)

• Eclipse插件开发系列（０）：Java Application开发的崛起(原作) • Eclipse插件开发系列（１）：Eclipse及其语言包的下载与安装(原作)

— 图书推荐 —

CSDN - 文档中心 - Java < td> 标题 Eclipse插件开发系列（４）：对话框Dialog glchengang（原作） 关键字 Eclipse 对话框 Dialog TitleAreaDialog Java算法——图算法(...垃圾收集STRUTS技术揭密及WEB...Java手机/PDA程序设计...作者：陈刚，桂林人,97年毕业于广西师范大学数学系，暂于IBM中国研究中心以外包人员身份从事软件开发(2004.2-?)，专注基于java平台的软件开发。 email: glchengang@hotmail.com blog: glchengang.yeah.net 一、最简单的Dialog。 在上一章中我们的Hello World是调用了SWT中已写好的一个对话框，如果我们要自己写一个对话框怎么办呢。很简单只需要继承JFace中的Dialog类，然后重写相应的方法就可以了。代码如下：

— 人才招聘 —

TOM互联网事业集团...深圳市智岛软件科...北京飞天诚信科技...北京云网公司(北京...北京开创明天科技...北京三维力控科技...北京东西电子研究...阿里巴巴（中国）...大连大有吴涛易语... — 培训信息 — 北京维新科技培训...中国软件(Oracle认...天盈隆网络技术培...美国Softtech公司...中国思科培训网(C...UML软件工程组织(...中国UNIX用户协会...东北大学计算机培...WWW.JAVASP.NET(电... import org.eclipse.jface.dialogs.Dialog; //注意这个是jface的Dialog,不是swt的Dialog import org.eclipse.swt.SWT;

import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Control; import org.eclipse.swt.widgets.Shell; import org.eclipse.swt.widgets.Text;

public class DialogSample extends Dialog {

/**

* 构造函数

* 注意:其范围由protected改为public,否则包外的类无法调用

*/

public DialogSample(Shell parentShell) { super(parentShell); }

/**

* 在这个方法里构建Dialog中的界面内容 */

protected Control createDialogArea(Composite parent) { getShell().setText(\"标题\"); //设置Dialog的标头

Text text = new Text(parent, SWT.BORDER); //设置一个Text控件 text.setText(\"我爱JAVA\"); //设置text中的内容 return parent;

}

/**

* 重载这个方法可以改变窗口的默认式样 * SWT.RESIZE：窗口可以拖动边框改变大小 * SWT.MAX： 窗口可以最大化 */

protected int getShellStyle() {

return super.getShellStyle() | SWT.RESIZE | SWT.MAX; }

}

这里出现了几个新的变量类型，在此简单解释如下：

• Composite ：本文中翻译成面板。任何SWT/JFace的界面控件都必须建立在某个面板上面，如上面的new Text(parent, SWT.BORDER)，就是将文本框建立在参数传入的面板parent上。面板还能嵌套面板，在建立一个图形界面时常将各个面板层层叠叠的排放在一起。Composite 将是界面设计中使用最平凡的一个类。

• Control 是Composite 的父类，而Shell 是Composite 的一个子类。用到的场合不是太多，也没太必要了解很清其本质含义。要依着我的开发经验的理解Control (控制)：如上面例程中createDialogArea方法就要返回一个Control 表示这些界面元素是由谁主控，或者是谁是主面板包含住了所有控件（我自己猜的）。Shell表示一个界面的外壳，它能得到比Composite 更多的功能。

• 希望通过如下继承关系图有助于您理解Control、Composite、Shell三者间的关系。

然后将上一章的SampleAction.java中的run方法改写如下：

public void run(IAction action) { /*

* 也可以new DialogSample(null); 传一个NULL这时是单开一个窗口 * 要看两者的区别，注意window操作系统任务条上的变化。

* 一般来说都应该传一个Shell类型的参数，至少这个Shell来自何处都一样。 */

Dialog dialog = new DialogSample(window.getShell()); dialog.open(); }

然后用上一单运行插件的方法跑一下看。结果界面如下：

二、如何设置与取得Dialog中的数据。

在我们开发中我们常需要设置对话框一些初值，另外Dialog点\"确定\"退出后，我们还想取得Text框的值。怎么做呢？我们可以在Dialog类中建立一个字符型的类变量来保存值。请看如下代码：

public class DialogSample extends Dialog { //类变量，设一个默认值

private String textValue = \"我爱JAVA\";

//将Text设为类变量，否则buttonPressed方法无法访问 private Text text; .......

protected Control createDialogArea(Composite parent) { .........

text = new Text(parent, SWT.BORDER); //将text的定义Text去掉 text.setText(textValue); //改成变量 ......... } ........

/**

* Dialog点击按钮时执行的方法 */

protected void buttonPressed(int buttonId) { //如果是点了OK按钮，则将值设置回类变量 if (buttonId == IDialogConstants.OK_ID) textValue = text.getText(); super.buttonPressed(buttonId); }

public String getTextValue() { //增加两个类变量的设值取值方法 return textValue; }

public void setTextValue(String string) { textValue = string;

} }

然后将SampleAction改为如下。

DialogSample dialog = new DialogSample(null); dialog.setTextValue(\"我也爱Eclipse\"); if (dialog.open() == Window.OK) {

System.out.println(\"新的值是：\" + dialog.getTextValue()); }

这时我们发现dialog启动后Text的值变成了“我也爱Eclipse”，然后我们在Dialog重新改一下Text框的值，点ＯＫ按钮，在原“控制台”窗口打印出了Dialog中新修改的字符。

三、如何增加按钮。

默认的Dialog只有两个按钮，有时候我们可能增加一些按钮。有两种方法。

１、方法一（稍复杂）。下面增加一个退出按钮，只须在原有DialogSample 类中重载父类Dialog的两个方法，这种方法可以调整三个按钮的前后位置并可以修改原来默认两个按钮（确定、取消）的设定（如文字、id值等）。

/**

* 重载默认的按钮建立方法，让其在本地的执行失效 */

protected Button createButton(Composite parent, int buttonId, String buttonText, boolean defaultButton) { return null; } /**

* 利用父类的createButton方法建立按钮

*/

protected void initializeBounds() { /*

* 参数1:取得放按钮的面板，

* 参数2:定交按钮的id值，id值的作用见上面的buttonPressed方法 * 参数3:按钮上的文字

* 参数4:是否为Dialog的默认按钮 */

super.createButton((Composite) this.getButtonBar(), IDialogConstants.CANCEL_ID, \"退出\ super.createButton((Composite) this.getButtonBar(), IDialogConstants.OK_ID, \"确定\ super.createButton((Composite) this.getButtonBar(), IDialogConstants.CANCEL_ID, \"取消\ super.initializeBounds(); }

２、方法二（简单）。就重载一个父类函数，在原来两个按钮后加上一个“退出”按钮，但这个方法就无法调整三个按钮的位置了。

protected void initializeBounds() {

super.createButton((Composite) this.getButtonBar(), IDialogConstants.CANCEL_ID, \"退出\ super.initializeBounds(); }

四、带提示栏的对话框。如下图

很简单将继承类从Dialog改为TitleAreaDialog 就行了。如下：

public class DialogSample extends TitleAreaDialog { ....... }

当然这还不够，我们还要对输入的值进行有效性检查，并根据检查判断是否要提示用户你的输入有误。

• 在这里我们加一个文本框修改的监听事件。

text.addModifyListener(new ModifyListener() { public void modifyText(ModifyEvent e) { if (text.getText().equals(\"123\")) { setErrorMessage(\"你不能输入123\");

getButton(IDialogConstants.OK_ID).setEnabled(false); //让OK按钮的置灰失效 } else {

setErrorMessage(null);

getButton(IDialogConstants.OK_ID).setEnabled(true); } }

});

• •

很多情况下，还有一种限定文本框只能输入数字的方法。

text.addVerifyListener(new VerifyListener() { public void verifyText(VerifyEvent e) { e.doit = \"01234567\".indexOf(e.text) >= 0; } });

源程序打包下载：myplugin2.rar

下一章预告：5.SWT的布局管理器

后记：这一章写了一个星期，平时工作很忙，写得真够累的，不知道对大家有没有帮助。有人开始在用Eclipse做插件开发了吗？还是在仅仅限于用Eclipse来写JSP吗？这一系列文章希望得到大家的反馈：太简单？太粗略？太难了？还想了解那些方面的？希望直接来信何在文章下跟帖。

作者相关文章：

• Eclipse插件开发系列（０）：Java Application开发的崛起(原作) • Eclipse插件开发系列（３）：Hello World插件(从无到有版)(原作) • Eclipse插件开发系列（１）：Eclipse及其语言包的下载与安装(原作)