GridLength Структура

Определение

public value class GridLength

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
struct GridLength

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public struct GridLength

Public Structure GridLength

<object property="doubleValue"/>
- or -
<object property="starSizing"/>
-or-
<object property="Auto"/>

Наследование

ValueType

GridLength

Атрибуты

ContractVersionAttribute

Примеры

В этом примере показано, как задать ширину столбцов сетки в 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:

Вот как задать те же значения в коде. Первые две длины сетки эквивалентны, но первый использует упрощенный конструктор.

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). Эти значения свойств используются для поддержки распределения доступного пространства в контейнерах макетов, таких как сетки (а также производные типы , такие как VariableSizedWrapGrid).

GridLength может описать один из трех режимов для изменения размера:

• Фиксированная ширина.
• Взвешемое распределение (размер звезды).
• Режим автоматического размера .

GridLength значения обычно объявляются в синтаксисе атрибута XAML. В XAML взвешемое распределение объявляется с помощью символа "*", предшествующего числу, которое объявляет коэффициент весового значения, используемого для этого GridLength. Параметр взвешированного распределения также известен как размер звезды.

Значения данных, удерживаемые значения , и GridUnitType доступны только для чтения. Если вы хотите изменить значение свойства, которое принимает GridLength во время выполнения, необходимо создать новое значение с помощью одного из конструкторов и заменить предыдущее значение.

Размер звезды

Размер звезды — это соглашение, в котором GridLength имеет числовое значение, указывающее взвешанный фактор и другие значения GridLength. Любые GridLength значения, использующие размер звезды, разделяют доступное пространство, учитывая факторы весового значения и оценивая после применения каких-либо фиксированных ширин. Если ни один из размеров звезд не имеет весовых факторов, высота или ширина делится одинаково между ними. Коэффициент весового значения по умолчанию равен 1.

В этой таблице приведены некоторые примеры результатов изменения размера звезд. В этих примерах предположим, что родительский сетки имеет фиксированную ширину 600, а также три столбца.

В коде размер звезд эквивалентен GridLength, где trueIsStar , GridUnitTypeStar, а значение является взвешанным фактором.

Допустимы не целочисленные факторы весовых значений; например, ".5*".

Автоматическое изменение размера

Автоматическое изменение размера распределяет пространство равномерно на основе размера содержимого, который находится в столбце или строке. Точную логику автоматического изменения размера реализует элемент управления или класс с помощью значений GridLength. Как правило, этот класс Grid, так как он интерпретирует его RowDefinition и компоненты ColumnDefinition.

Заметки о синтаксисе XAML

Хотя можно указать GridLength в качестве элемента объекта, нельзя указать отдельные значения, например Value, в качестве атрибутов этого элемента объекта. Средство синтаксического анализа XAML не поддерживает настройку значений атрибутов XAML для этой структуры. Вместо этого необходимо указать значения в виде текста инициализации в GridLength. Дополнительные сведения о тексте инициализации XAML см. в руководстве по синтаксису XAML .

Проекция и члены GridLength

Если вы используете C#, GridLength имеет доступные не данные, а его члены данных предоставляются как свойства только для чтения, а не поля. См. GridLength в браузере API .NET.

Если вы программируются с помощью C++/WinRT или библиотеки шаблонов среды выполнения Windows C++ (WRL), то только поля элементов данных существуют как члены GridLength, и нельзя использовать служебные методы или свойства проекции .NET. Код C++ может получить доступ к аналогичным методам служебной программы, существующим в классе GridLengthHelper.

В этой таблице показаны эквивалентные свойства и методы, доступные в .NET и C++.

Поля

Применяется к

См. также раздел

• Grid
• ColumnDefinition
• RowDefinition
• Width
• Height
• GridUnitType
• макеты с XAML