GridLayout

GridLayout 是更有力的(和更複雜的)的佈置之一。 GridLayout 在格線中佈置 Widget,提供了許多可配置參數,來控制調整組 合大小時格線列和欄的操作方式。

GridLayout 定義控制整體佈置策略的 API。最重要的屬性為 numColumns,它可決定格線 的水平大小。通常您在第一次設定視窗外觀時決定此值。格線中 Widget 的順序與您建 立它們的順序相同。若要變更格線中 Widget 的順序,您可以使用 Control 方法 moveAbove(Control)moveBelow(Control)。這些方法可讓 Widget 在佈置中插入彼此的前的後。("above" 和 "below" 指 示 Widget Z 順序,不是格線本身的位置。)

下表彙總 GridLayout 的可配置參數。

屬性

說明

horizontalSpacing

一個資料格右邊緣及其鄰接資料格左邊緣之間的圖素數目。

makeColumnsEqualWidth

指定所有直欄是否強制為相同寬度。

marginWidth

用於格線右邊緣和左邊緣上邊距的圖素數目。

marginHeight

用於格線上邊緣和下邊緣上邊距的圖素數目。

numColumns

用來製作格線的直欄數。

verticalSpacing

一個資料格下邊緣及其鄰接資料格上邊緣之間的圖素數目。

GridLayout 支援格線中每一個 Widget 其他許多佈置參數。 這些內容指定於 GridData 物件中。您必須在格線中對每一個 Widget 將 GridData 設為 layoutData

GridData 類別定義讓您在 GridData 建構子中指定常用佈置參數組合的樣式常數。您也可以在 GridData 中使用 public 方法來個別設定這些屬性。

您可以使用 GridData 來達到一些非常機動且複雜的佈置。對格線中不同的 Widget 轉換這些值,會產生不同的 佈置組合。甚至是最複雜的對話框佈置也可使用 GridData 來指定。讓 Widget 跨越資料格的功能會產生許多甚至不像格線的佈置。

下表彙總 GridData 的可配置參數。 有關使用各種格線參數的進一步說明和範例擷取畫面,請參閱瞭解 SWT 中的佈置

屬性

說明

grabExcessHorizontalSpace

指定是否加大資料格來使用格線中任何可用的額外水平空間。依據 Widget 及其格線資 料計算格線中的資料格大小後,「組合」中剩餘的任何額外空間會配置給佔據過多空 間的那些資料格。

grabExcessVerticalSpace

指定是否加大資料格來使用格線中任何可用的額外垂直空間。

heightHint

指定 Widget 的最小高度(使適合包含它的列)。

horizontalAlignment

可以是 BEGINNINGCENTERENDFILL 其中之一。 FILL 表示將調整 Widget 大小使佔滿其格線資料格的整個寬度。

horizontalIndent

Widget 及其格線資料格左邊緣之間的圖素數目。

horizontalSpan

指定格線中 Widget 將跨過的直欄數。依預設,Widget 會佔滿格線中一個資料格。可藉由增加此值依水平方向佔滿其他資料格。

verticalAlignment

可以是 BEGINNINGCENTERENDFILL 其中之一。 FILL 表示將調整 Widget 大小使佔滿其格線資料格的整個高度。

verticalSpan

指定格線中 Widget 將跨過的列數。依預設,Widget 會佔滿格線中一個資料格。可藉由 增加此值依垂直方向佔滿其他資料格。

widthHint

指定 Widget 的最小寬度(使適合包含它的直欄)。

Copyright IBM Corp. and others 2000,2002.