1、介紹
l Eclipse Form是Eclipse 3.0的新特性
l Eclipse Form是一組定制小部件和支持類組成的插件，以前由PDE和Update組件內(nèi)部使用，在Eclipse 3.0中已經(jīng)成為公用API
l Eclipse Form提供：
n 適合包含到內(nèi)容區(qū)域（編輯器或視圖）中的“Form”概念
n 用來(lái)管理顏色、超鏈接組和其它象SWT控件一樣的Form外觀的工具包
n 象HTML表格一樣布局的新布局管理器
n 為Form設(shè)計(jì)的定制控件（超鏈接、圖像鏈接、可滾動(dòng)的composite等）
n 每頁(yè)是一個(gè)Form的多頁(yè)編輯器（就象PDE）
2、快速入門
（1）HelloWorld例子
l 下面的例子在視圖中創(chuàng)建一個(gè)空的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();
}
}
l 首先要?jiǎng)?chuàng)建FormToolkit對(duì)象實(shí)例
l 由FormToolkit創(chuàng)建Form對(duì)象（這里是ScrolledForm）
l 調(diào)用ScrolledForm的setText()方法，在Form的頂部設(shè)置標(biāo)題內(nèi)容
l 注意：最后要dispose管理資源的FormToolkit對(duì)象
l 要在Workbench中運(yùn)行，需要plugin.xml中，將org.eclipse.ui.forms添加到必需插件列表，并注冊(cè)視圖
<?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）添加內(nèi)容
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!"); }
});
}
l 首先獲得Form的體內(nèi)容，它是一個(gè)Composite對(duì)象
l 設(shè)置其布局為GridLayout
l 通過(guò)FormToolkit創(chuàng)建一個(gè)超鏈接（Hyperlink）控件
l 添加超鏈接事件偵聽(tīng)器，響應(yīng)超鏈接的點(diǎn)擊
（3）添加通用控件
l 由于Form的體內(nèi)容是一個(gè)Composite對(duì)象，所以允許在其中創(chuàng)建SWT控件
l 但是SWT控件是被設(shè)計(jì)為適合窗口、對(duì)話框的，所以在Form中使用是有問(wèn)題的
l 在Form中，使用FormToolkit創(chuàng)建對(duì)應(yīng)的通用控件
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);
}
l 上面的例子添加了三個(gè)通用控件：Label、Text和CheckBox
l 由于缺省創(chuàng)建的Text控件的外觀是3D的，而要達(dá)到象PDE一樣的FLAT外觀，需要做些額外工作：
n 調(diào)用setData()方法，添加重畫邊框的附加信息
n 調(diào)用FormToolkit的paintBordersFor()方法重畫FLAT外觀的邊框