GridLength 結構

  • 參考

定義

命名空間:
Windows.UI.Xaml
編輯

表示明確支援 Star (*) 調整大小和 自動 調整大小的控制項邏輯度量。

public value class GridLength
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct GridLength
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct GridLength
Public Structure GridLength
<object property="doubleValue"/>
- or -
<object property="starSizing"/>
-or-
<object property="Auto"/>
繼承
ValueType
GridLength
屬性
ContractVersionAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範如何在 XAML 中設定格線資料行寬度，無論是資源或直接設定為 Width 屬性值。

<Grid>
    <Grid.Resources>
        <GridLength x:Key="gridLength200">200</GridLength>
        <GridLength x:Key="gridLength2star">2*</GridLength>
    </Grid.Resources>
    <Grid.ColumnDefinitions>
        <ColumnDefinition x:Name="gridColumn0" Width="{StaticResource gridLength200}"/>
        <ColumnDefinition x:Name="gridColumn1" Width="200"/>
        <ColumnDefinition x:Name="gridColumn2" Width="Auto"/>
        <ColumnDefinition x:Name="gridColumn3" Width="3*"/>
        <ColumnDefinition x:Name="gridColumn4" Width="{StaticResource gridLength2star}"/>
        <ColumnDefinition x:Name="gridColumn5" Width="*"/>
    </Grid.ColumnDefinitions>
    <Border Background="Red" Grid.Column="0"/>
    <Border Background="Orange" Grid.Column="1"/>
    <Border Background="Yellow" Grid.Column="2" Width="100"/>
    <Border Background="Green" Grid.Column="3"/>
    <Border Background="Blue" Grid.Column="4"/>
    <Border Background="Violet" Grid.Column="5"/>
</Grid>

XAML 會在 Visual Studio 設計工具中產生此輸出：

gridlength XAML 範例的轉譯輸出

以下是如何在程式碼中設定相同的值。 前兩個方格長度相等，但第一個方格長度使用簡化的建構函式。

gridColumn0.Width = new GridLength(200);
gridColumn1.Width = new GridLength(200, GridUnitType.Pixel);
gridColumn2.Width = new GridLength(0, GridUnitType.Auto);
gridColumn3.Width = new GridLength(3, GridUnitType.Star);
gridColumn4.Width = new GridLength(2, GridUnitType.Star);
gridColumn5.Width = new GridLength(1, GridUnitType.Star);

備註

ColumnDefinition和RowDefinition之類的類型會針對某些屬性使用 GridLength 值， (ColumnDefinition.Width和RowDefinition.Height) 。 這些屬性值可用來支援 配置 容器中可用空間的變數分佈，例如 Grid (，以及 Grid 的衍生類型，例如 VariableSizedWrapGrid) 。

GridLength 可以描述三種調整大小的模式之一：

  • 固定寬度。
  • 加權分佈 (star 調整大小) 。
  • 「自動」調整大小模式。

GridLength 值通常會在 XAML 屬性語法中宣告。 在 XAML 中，加權分佈是使用 「*」 符號來宣告，前面會加上數位，這個數位會宣告要用於該 GridLength 的加權因數。 加權分配選項也稱為star調整大小。

GridLength 所保留的資料值 (Value 和 GridUnitType) 都是唯讀的。 如果您想要變更在執行時間接受 GridLength 的屬性值，您必須使用其中一個建構函式建立新的值，並取代先前的值。

調整大小

重設星號是一種慣例，其中 GridLength 具有指定加權因數與其他 GridLength 值的數值。 任何使用star調整大小的 GridLength 值會除以可用空間、考慮加權因數，以及在套用任何固定寬度之後進行評估。 如果沒有任何star調整大小具有加權因數，則高度或寬度會平均分割在兩者之間。 預設加權因數為 1。

下表提供star調整大小結果的一些範例。 在這些範例中，假設父 方格 的固定寬度為 600，且有三個數據行。

欄 0 第 1 欄 第 2 欄 結果
100 100 * 100,100,400
100 * * 100,250,250
100 * 4* 100,100,400

在程式碼中，star調整大小相當於IsStar為 true的 GridLength、GridUnitType為Star，而Value則是套用加權因數。

允許非整數加權因數;例如，「.5*」。

自動調整大小

自動調整大小會根據資料行或資料列內的內容大小平均分配空間。 自動調整大小的確切邏輯是由控制項或類別使用 GridLength 值來實作。 該類別通常是 Grid，因為它會解譯其 RowDefinition 和 ColumnDefinition 元件。

XAML 語法的注意事項

雖然您可以將 GridLength 指定為物件專案，但無法指定個別的值，例如 Value，做為該物件元素的屬性。 XAML 剖析器不支援為此結構設定 XAML 屬性值。 相反地，您必須將值指定為 GridLength 內的初始化文字。 如需 XAML 初始化文字的詳細資訊，請參閱 XAML 語法指南。

GridLength 的投影和成員

如果您使用 Microsoft .NET 語言 (C# 或 Microsoft Visual Basic) ，或 Visual C++ 元件延伸模組 (C++/CX) ，則 GridLength 有非資料成員可用，且其資料成員會公開為唯讀屬性，而非欄位。 請參閱 .NET API 瀏覽器中的 GridLength 。

如果您使用C++/WinRT或Windows 執行階段 C++ 樣板庫 (WRL) 進行程式設計，則只有資料成員欄位會以 GridLength 的成員的形式存在，而且您無法使用 .NET 投影的公用程式方法或屬性。 C++ 程式碼可以存取 GridLengthHelper 類別上存在的類似公用程式方法。

下表顯示 .NET 和 C++ 中可用的對等屬性和方法。

.NET (GridLength) C++ (GridLengthHelper)
GridLength (Double) FromPixels (Double)
GridLength (Double、GridUnitType) FromValueAndType (Double、GridUnitType)
Auto Auto
等於 Equals (GridLength、GridLength)
IsAbsolute GetIsAbsolute (GridLength)
IsAuto GetIsAuto (GridLength)
IsStar GetIsStar (GridLength)

欄位

GridUnitType

GridUnitType列舉的值，可限定Value解譯為量值的方式。
Value

此 GridLength 的量值，這不一定是圖元量值。

適用於

另請參閱