SWT/JFace FillLayout 佈局管理器：最簡單的等分佈局指南

前言

FillLayout 是 SWT 中最簡單的佈局管理器。它將父容器的客戶區域平均劃分給所有子元件，每個元件獲得相同尺寸，排列方向可選水平或垂直。適合工具欄、狀態欄、單元件填滿等簡單場景。

核心特性

• 等分原則：所有子元件寬高相同（水平模式下高度相同、寬度均分；垂直模式下寬度相同、高度均分）。
• 單行/單列：不支援換行/換列，超出範圍元件將被截斷或擠壓。
• 極簡 API：僅有方向、邊距、間距三類屬性。

構造與屬性

// 構造：指定方向
FillLayout layout = new FillLayout(SWT.HORIZONTAL); // 預設水平
FillLayout layout = new FillLayout(SWT.VERTICAL);   // 垂直

// 屬性
layout.marginWidth = 5;   // 左右邊距
layout.marginHeight = 5;  // 上下邊距
layout.spacing = 3;       // 元件間距

// 套用
shell.setLayout(layout);

完整範例：垂直排列三個按鈕

public class FillLayoutSample {
    public static void main(String[] args) {
        Display display = new Display();
        Shell shell = new Shell(display);
        shell.setText("FillLayout Demo");

        FillLayout layout = new FillLayout(SWT.VERTICAL);
        layout.marginHeight = 5;
        layout.marginWidth = 5;
        layout.spacing = 1;
        shell.setLayout(layout);

        new Button(shell, SWT.PUSH).setText("button1");
        new Button(shell, SWT.PUSH).setText("button number 2");
        new Button(shell, SWT.PUSH).setText("3");

        shell.pack();
        shell.open();
        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) display.sleep();
        }
        display.dispose();
    }
}

適用場景與限制

進階技巧

1. 單元件填滿（最常用）

shell.setLayout(new FillLayout()); // 預設水平
Text text = new Text(shell, SWT.MULTI | SWT.BORDER | SWT.H_SCROLL | SWT.V_SCROLL);
// Text 自動填滿整個 Shell 客戶區

2. 結合 Composite 分區

// 頂層垂直分區：工具欄 + 內容區
FillLayout mainLayout = new FillLayout(SWT.VERTICAL);
shell.setLayout(mainLayout);

Composite toolbar = new Composite(shell, SWT.NONE);
toolbar.setLayout(new FillLayout(SWT.HORIZONTAL));
new Button(toolbar, SWT.PUSH).setText("New");
new Button(toolbar, SWT.PUSH).setText("Open");
new Button(toolbar, SWT.PUSH).setText("Save");

Composite content = new Composite(shell, SWT.BORDER);
content.setLayout(new FillLayout()); // 單元件填滿
new Text(content, SWT.MULTI | SWT.BORDER);

3. 動態切換方向

FillLayout layout = new FillLayout(SWT.HORIZONTAL);
shell.setLayout(layout);

// 運行時切換
Button toggle = new Button(shell, SWT.CHECK);
toggle.setText("Vertical");
toggle.addListener(SWT.Selection, e -> {
    layout.type = toggle.getSelection() ? SWT.VERTICAL : SWT.HORIZONTAL;
    shell.layout(true); // 重新佈局
});

與其他佈局對比

總結

FillLayout 是「簡單場景的最佳選擇」：

• 一行代碼搞定等分/填滿。
• 零配置即可工作，維護成本極低。
• 組合 Composite可構建多層次簡單介面。
• 超出能力範圍時，果斷升級到 RowLayout/GridLayout/FormLayout。

記住：簡單就是力量。當 FillLayout 滿足需求時，不要引入更複雜的佈局。