Eclipse Form程序设计快速入门(一)

2014-11-23 21:39:54 · 作者: · 浏览: 42
1、介绍

   Eclipse Form是Eclipse 3.0的新特性。

   Eclipse Form是一组定制小部件和支持类组成的插件,以前由PDE和Update 组件内部使用,在Eclipse 3.0中已经成为公用API。

   Eclipse Form提供:

   适合包含到内容区域(编辑器或视图)中的“Form”概念

   用来管理颜色、超链接组和其它象SWT控件一样的Form外观的工具包

   象HTML表格一样布局的新布局管理器

   为Form设计的定制控件(超链接、图像链接、可滚动的composite等)

   每页是一个Form的多页编辑器(就象PDE)

   2、快速入门

   (1)HelloWorld例子

   下面的例子在视图中创建一个空的Form

public class FormView extends ViewPart {

private FormToolkit toolkit;
private ScrolledForm form;

public void createPartControl(Composite parent) {
  toolkit = new FormToolkit(parent.getDisplay());
  form = toolkit.createScrolledForm(parent);
  form.setText("Hello, Eclipse Forms");
}

public void setFocus() {
  form.setFocus();
}

public void dispose() {
  toolkit.dispose();
  super.dispose();
}
}

   首先要创建FormToolkit对象实例

   由FormToolkit创建Form对象(这里是ScrolledForm)

   调用ScrolledForm的setText()方法,在Form的顶部设置标题内容

   注意:最后要dispose管理资源的FormToolkit对象

   要在Workbench中运行,需要plugin.xml中,将org.eclipse.ui.forms添加到必需插件列表,并注册视图

< xml version="1.0" encoding="UTF-8" >
< eclipse version="3.0" >
<plugin
id="FormSamples"
name="FormSamples Plug-in"
version="1.0.0"
provider-name="nelson_tu"
class="org.xqtu.samples.FormSamplesPlugin">

<runtime>
<library name="FormSamples.jar">
<export name="*"/>
</library>
</runtime>

<requires>
<import plugin="org.eclipse.ui"/>
<import plugin="org.eclipse.core.runtime"/>
<import plugin="org.eclipse.ui.forms"/>
</requires>

<extension
point="org.eclipse.ui.views">
<view
class="org.xqtu.samples.views.FormView"
name="Form Sample"
id="FormView"/>
</extension>
</plugin>

   (2)添加内容

public void createPartControl(Composite parent) {
  toolkit = new FormToolkit(parent.getDisplay());
  form = toolkit.createScrolledForm(parent);
  form.setText("Hello, Eclipse Forms");

  Composite body = form.getBody();
  GridLayout layout = new GridLayout();
  body.setLayout(layout);
  Hyperlink link = toolkit.createHyperlink(body, "Click here.",SWT.WRAP);
  link.addHyperlinkListener(new HyperlinkAdapter() {
   public void linkActivated(HyperlinkEvent e) {
    System.out.println("Link activated!");
   }
  });
}

   首先获得Form的体内容,它是一个Composite对象

   设置其布局为GridLayout

   通过FormToolkit创建一个超链接(Hyperlink)控件

   添加超链接事件侦听器,响应超链接的点击

   (3)添加通用控件

   由于Form的体内容是一个Composite对象,所以允许在其中创建SWT控件

   但是SWT控件是被设计为适合窗口、对话框的,所以在Form中使用是有问题的

   在Form中,使用FormToolkit创建对应的通用控件

public void createPartControl(Composite parent) {
  toolkit = new FormToolkit(parent.getDisplay());
  form = toolkit.createScrolledForm(parent);
  form.setText("Hello, Eclipse Forms");

  Composite body = form.getBody();
  GridLayout layout = new GridLayout();
  body.setLayout(layout);
  Hyperlink link = toolkit.createHyperlink(body, "Click here.",SWT.WRAP);
  link.addHyperlinkListener(new HyperlinkAdapter() {
   public void linkActivated(HyperlinkEvent e) {
    System.out.println("Link activated!");
   }
  });

  layout.numColumns = 2;
  GridData gd = new GridData();
  gd.horizontalSpan = 2;
  link.setLayoutData(gd);
  Label label = toolkit.createLabel(body, "Text field label:");
  Text text = toolkit.createText(body, "");
  text.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
  text.setData(FormToolkit.KEY_DRAW_BORDER, FormToolkit.TEXT_BORDER);
  Button button = toolkit.createButton(body,"An example of a checkbox in a form", SWT.CHECK);
  gd = new GridData();
  gd.horizontalSpan = 2;
  button.setLayoutData(gd);
  toolkit.paintBordersFor(body);
}

   上