Compartir a través de


UniformGridLayout Clase

Definición

Coloca los elementos secuencialmente de izquierda a derecha o de arriba abajo en un diseño de ajuste.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class UniformGridLayout : VirtualizingLayout
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class UniformGridLayout : VirtualizingLayout
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class UniformGridLayout : VirtualizingLayout
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class UniformGridLayout : VirtualizingLayout
Public Class UniformGridLayout
Inherits VirtualizingLayout
Herencia
Atributos
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta ItemsRepeater.

Las aplicaciones WinUI 3 Gallery y WinUI 2 Gallery incluyen ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 3 y WinUI 2.

Si ya se instalaron, haga clic en los vínculos siguientes para abrirlas: WinUI 3 Gallery o WinUI 2 Gallery.

Si no están instaladas, puede descargar WinUI 3 Gallery y WinUI 2 Gallery desde Microsoft Store.

También puede obtener el código fuente de ambas desde GitHub (use la bifurcación principal para WinUI 3 y la bifurcación winui2 para WinUI 2).

En el ejemplo siguiente se muestra cómo establecer la propiedad ItemsRepeater.Layout en uniformGridLayout.

<!--
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
...
<muxc:ItemsRepeater ItemsSource="{x:Bind Items}"
                    ItemTemplate="{StaticResource MyTemplate}">
    <muxc:ItemsRepeater.Layout>
        <muxc:UniformGridLayout MinItemWidth="200"
                                MinColumnSpacing="28"
                                ItemsJustification="SpaceAround"/>
    </muxc:ItemsRepeater.Layout>
</muxc:ItemsRepeater>

Comentarios

Los elementos se colocan en orden de izquierda a derecha cuando la orientación es Horizontaly se colocan de arriba a abajo cuando orientation es Vertical.

Cada elemento de un uniformGridLayout tiene el mismo tamaño.

UniformGridLayout admite la virtualización cuando se adjunta a un host que admite la virtualización.

Constructores

UniformGridLayout()

Inicializa una nueva instancia de la clase UniformGridLayout .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

ItemsJustification

Obtiene o establece un valor que indica cómo se alinean los elementos en el eje que no se desplaza o no virtualiza.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ItemsJustificationProperty

Identifica la propiedad de dependencia ItemsJustification .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ItemsStretch

Obtiene o establece un valor que indica cómo se ajusta el tamaño de los elementos para rellenar el espacio disponible.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ItemsStretchProperty

Identifica la propiedad de dependencia ItemsStretch .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MaximumRowsOrColumns

Obtiene o establece el número máximo de elementos representados por fila o columna, en función de la orientación de UniformGridLayout.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MaximumRowsOrColumnsProperty

Identifica la propiedad de dependencia MaximumRowsOrColumns .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinColumnSpacing

Obtiene o establece el espacio mínimo entre los elementos del eje horizontal.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinColumnSpacingProperty

Identifica la propiedad de dependencia MinColumnSpacing .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinItemHeight

Obtiene o establece el alto mínimo de cada elemento.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinItemHeightProperty

Identifica la propiedad de dependencia MinItemHeight .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinItemWidth

Obtiene o establece el ancho mínimo de cada elemento.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinItemWidthProperty

Identifica la propiedad de dependencia MinItemWidth .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinRowSpacing

Obtiene o establece el espacio mínimo entre los elementos del eje vertical.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinRowSpacingProperty

Identifica la propiedad de dependencia MinRowSpacing .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Orientation

Obtiene o establece el eje a lo largo del cual se diseñan los elementos.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

OrientationProperty

Identifica la propiedad de dependencia Orientation .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Métodos

Arrange(LayoutContext, Size)

Coloca los elementos secundarios y determina un tamaño para un uiElement contenedor. Los elementos de contenedor que admiten diseños adjuntos deben llamar a este método desde sus implementaciones de invalidación de diseño para formar una actualización de diseño recursiva.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)

Cuando se implementa en una clase derivada, proporciona el comportamiento del paso "Organizar" del diseño. Las clases pueden invalidar este método para definir su propio comportamiento de paso "Organizar".

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de VirtualizingLayout)
InitializeForContext(LayoutContext)

Inicializa cualquier estado por contenedor que requiera el diseño cuando se adjunta a un contenedor UIElement.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
InitializeForContextCore(VirtualizingLayoutContext)

Cuando se reemplaza en una clase derivada, inicializa cualquier estado por contenedor que requiera el diseño cuando se adjunta a un contenedor UIElement.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de VirtualizingLayout)
InvalidateArrange()

Invalida el estado de organización (diseño) para todos los contenedores UIElement que hacen referencia a este diseño. Después de la invalidación, UIElement tendrá actualizado su diseño, que se produce de forma asincrónica.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
InvalidateMeasure()

Invalida el estado de medición (diseño) para todos los contenedores UIElement que hacen referencia a este diseño.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
Measure(LayoutContext, Size)

Sugiere un objeto DesiredSize para un elemento contenedor. Un elemento contenedor que admita diseños adjuntos debe llamar a este método desde sus propias implementaciones measureOverride para formar una actualización de diseño recursiva. Se espera que el diseño adjunto llame a measure para cada uno de los elementos secundarios UIElement del contenedor.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
MeasureOverride(VirtualizingLayoutContext, Size)

Proporciona el comportamiento del paso "Measure" del ciclo de diseño. Las clases pueden invalidar este método para definir su propio comportamiento de paso de "Medida".

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)

Notifica al diseño cuando la colección de datos asignada al elemento contenedor (ItemsSource) ha cambiado.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de VirtualizingLayout)
UninitializeForContext(LayoutContext)

Quita cualquier estado que el diseño haya almacenado anteriormente en el contenedor UIElement.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

Cuando se reemplaza en una clase derivada, quita cualquier estado que el diseño almacenado anteriormente en el contenedor UIElement.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de VirtualizingLayout)

Eventos

ArrangeInvalidated

Se produce cuando se ha invalidado el estado de organización (diseño).

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)
MeasureInvalidated

Se produce cuando se ha invalidado el estado de medición (diseño).

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

(Heredado de Layout)

Se aplica a

Consulte también