GridLength Estructura

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Representa una medida para la lógica de control que admite explícitamente Star (*) ajuste de tamaño y ajuste de tamaño automático de.

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"/>

Herencia

ValueType

GridLength

Atributos

ContractVersionAttribute

Ejemplos

En este ejemplo se muestra cómo establecer los anchos de columna de cuadrícula en XAML, ya sea como un recurso o directamente como un valor de propiedad 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>

El CÓDIGO XAML genera esta salida en el diseñador de Visual Studio:

Aquí se muestra cómo establecer los mismos valores en el código. Las dos primeras longitudes de cuadrícula son equivalentes, pero la primera usa el constructor simplificado.

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);

Comentarios

Los tipos como columnDefinition y RowDefinition usan valores de GridLength para algunas de sus propiedades ( ColumnDefinition.Width y RowDefinition.Height). Estos valores de propiedad se usan para admitir la distribución variable de espacio disponible en contenedores de diseño, como Grid (y también tipos derivados de Grid, como VariableSizedWrapGrid).

Un GridLength puede describir uno de los tres modos de ajuste de tamaño:

• Ancho fijo.
• Una distribución ponderada (ajuste de tamaño de estrella).
• Un modo de ajuste de tamaño de automático de .

GridLength valores normalmente se declaran en la sintaxis de atributo XAML. En XAML, la distribución ponderada se declara mediante un símbolo "*", precedido por un número que declara el factor de ponderación que se va a usar para ese GridLength. La opción de distribución ponderada también se conoce como tamaño de estrella.

Los valores de datos mantenidos por un value de y gridUnitType son de solo lectura. Si desea cambiar el valor de una propiedad que toma un GridLength en tiempo de ejecución, debe crear un nuevo valor mediante uno de los constructores y reemplazar el valor anterior.

Ajuste de tamaño de estrella

El ajuste de tamaño de estrella es una convención por la que un GridLength tiene un valor numérico que especifica un factor ponderado frente a otros valores de GridLength. Los valores de GridLength que usan el tamaño de estrella dividen el espacio disponible, tienen en cuenta los factores de ponderación y se evalúan después de aplicar los anchos fijos. Si ninguno de los tamaños de estrella tiene factores de ponderación, el alto o el ancho se divide igualmente entre ellos. El factor de ponderación predeterminado es 1.

En esta tabla se proporcionan algunos ejemplos de resultados de ajuste de tamaño de estrella. En estos ejemplos, supongamos que el primario Grid tiene un ancho fijo de 600 y que hay tres columnas.

Columna 0	Columna 1	Columna 2	Resultado
100	100	*	100,100,400
100	*	*	100,250,250
100	*	4*	100,100,400

En el código, un ajuste de tamaño de estrella es equivalente a un GridLength donde IsStar es true, gridUnitType es Stary Value es el factor ponderado aplicado.

Se permiten factores de ponderación no enteros; por ejemplo, ".5*".

Ajuste de tamaño automático

El ajuste de tamaño automático distribuye el espacio uniformemente en función del tamaño del contenido que se encuentra dentro de una columna o fila. La lógica exacta para el ajuste de tamaño automático se implementa mediante el control o la clase mediante los valores de GridLength. Normalmente, esa clase es Grid, ya que interpreta sus componentes RowDefinition y ColumnDefinition.

Notas sobre la sintaxis XAML

Aunque puede especificar un GridLength como un elemento de objeto, no puede especificar los valores individuales, como Value, como atributos de ese elemento de objeto. El analizador XAML no admite el establecimiento de valores de atributo XAML para esta estructura. En su lugar, debe especificar los valores como texto de inicialización dentro del GridLength. Para obtener más información sobre el texto de inicialización XAML, consulta guía de sintaxis XAML.

Proyección y miembros de GridLength

Si usa C#, GridLength tiene miembros que no son de datos disponibles y sus miembros de datos se exponen como propiedades de solo lectura, no campos. Consulte GridLength en el explorador de API de .NET.

Si está programando con de C++/WinRT o la biblioteca de plantillas de C++ de Windows Runtime (WRL), solo los campos de miembro de datos existen como miembros de GridLengthy no puede usar los métodos o propiedades de la utilidad de la proyección de .NET. El código de C++ puede tener acceso a métodos de utilidad similares que existen en la clase gridLengthHelper .

En esta tabla se muestran las propiedades y métodos equivalentes disponibles en .NET y C++.

.NET (GridLength)	C++ (GridLengthHelper)
GridLength(Double)	FromPixels(Double)
gridLength(Double, GridUnitType)	FromValueAndType(Double, GridUnitType)
auto	auto
equals	Equals(GridLength, GridLength)
isAbsolute	GetIsAbsolute(GridLength)
IsAuto	GetIsAuto(GridLength)
IsStar	GetIsStar(GridLength)

Campos

GridUnitType	Valor de la enumeración GridUnitType que califica cómo se interpreta Value como medida.
Value	La medida para esta GridLength, que no es necesariamente una medida de píxeles.

Consulte también

• Grid
• ColumnDefinition
• RowDefinition
• Width
• Height
• GridUnitType
• Diseños con XAML