Eclipse Forms 快速入門：構建專業級 UI 的表單式編輯器框架

Eclipse Forms (org.eclipse.ui.forms) 是 Eclipse 3.0 引入的 UI 工具套件，專為構建「表單式」編輯器/檢視設計 — 類似屬性頁、Wizard、PDE 插件清單編輯器。本文從 HelloWorld 到佈局管理、自定義控制項、邊框繪製，帶您快速掌握核心 API。

核心類別速覽

階段 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();
    }
}

plugin.xml 關鍵配置

<extension point="org.eclipse.ui.views">
  <view class="com.example.FormView" name="Form Sample" id="FormView"/>
</extension>
<requires>
  <import plugin="org.eclipse.ui.forms"/> <!-- 必須相依 -->
</requires>

階段 2：添加內容與超連結

Composite body = form.getBody();
GridLayout layout = new GridLayout(); // 或 TableWrapLayout
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!");
    }
});

階段 3：使用 FormToolkit 建立標準控制項 (扁平化外觀)

直接使用 SWT 控制項會呈現 3D 原生外觀，不符合 Forms 風格。必須透過 `FormToolkit` 建立：

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 checkbox = toolkit.createButton(body, "An example of a checkbox in a form", SWT.CHECK);
gd = new GridData(); gd.horizontalSpan = 2;
checkbox.setLayoutData(gd);

// 統一重繪所有工具包建立控制項的邊框
toolkit.paintBordersFor(body);

關鍵點解析

• `FormToolkit.createText()` 建立的 Text 預設無邊框，需設定 `KEY_DRAW_BORDER` 客屬性啟用扁平邊框。
• `paintBordersFor(Composite)` 遞迴重繪該容器下所有工具包管理控制項的邊框 (Focus、Hover 狀態)。
• 色彩/字型統一由 `FormToolkit` 管理，支援高對比度、系統主題切換自動適配。

TableWrapLayout twLayout = new TableWrapLayout();
twLayout.numColumns = 3;
body.setLayout(twLayout);

Label l1 = toolkit.createLabel(body, "Name:");
Text t1 = toolkit.createText(body, "");
TableWrapData td1 = new TableWrapData(TableWrapData.FILL_GRAB);
td1.colspan = 2; // 跨兩欄
t1.setLayoutData(td1);

Section section = toolkit.createSection(body, Section.TITLE_BAR | Section.TWISTIE);
section.setText("Advanced Options");
section.setLayout(new TableWrapLayout());
section.setLayoutData(new TableWrapData(TableWrapData.FILL_GRAB));
// ... 向 section.getClient() 添加子控制項