UniformGridLayout Clase

Definición

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

/// [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
Object IInspectable DependencyObject Layout VirtualizingLayout UniformGridLayout
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.

La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, las características y la funcionalidad de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

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 orientation 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 .

Propiedades

Dispatcher

Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. En su lugar, use DispatcherQueue .

(Heredado de DependencyObject)
DispatcherQueue

Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código.

(Heredado de DependencyObject)
IndexBasedLayoutOrientation

Obtiene la orientación, si existe, en la que los elementos se disponen en función de su índice en la colección de origen.

(Heredado de Layout)
ItemsJustification

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

ItemsJustificationProperty

Identifica la propiedad de dependencia ItemsJustification .

ItemsStretch

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

ItemsStretchProperty

Identifica la propiedad de dependencia ItemsStretch .

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.

MaximumRowsOrColumnsProperty

Identifica la propiedad de dependencia MaximumRowsOrColumns .

MinColumnSpacing

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

MinColumnSpacingProperty

Identifica la propiedad de dependencia MinColumnSpacing .

MinItemHeight

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

MinItemHeightProperty

Identifica la propiedad de dependencia MinItemHeight .

MinItemWidth

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

MinItemWidthProperty

Identifica la propiedad de dependencia MinItemWidth .

MinRowSpacing

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

MinRowSpacingProperty

Identifica la propiedad de dependencia MinRowSpacing .

Orientation

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

OrientationProperty

Identifica la propiedad de dependencia Orientation .

Métodos

Arrange(LayoutContext, Size)

Coloca los elementos secundarios y determina un tamaño para un uiElement de 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.

(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".

(Heredado de VirtualizingLayout)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad de dependencia.

(Heredado de DependencyObject)
CreateDefaultItemTransitionProvider()

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

(Heredado de Layout)
GetAnimationBaseValue(DependencyProperty)

Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa.

(Heredado de DependencyObject)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject.

(Heredado de DependencyObject)
InitializeForContext(LayoutContext)

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

(Heredado de Layout)
InitializeForContextCore(VirtualizingLayoutContext)

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

(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á su diseño actualizado, que se produce de forma asincrónica.

(Heredado de Layout)
InvalidateMeasure()

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

(Heredado de Layout)
Measure(LayoutContext, Size)

Sugiere un 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.

(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".

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

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

(Heredado de VirtualizingLayout)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si se establece un valor local.

(Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject .

(Heredado de DependencyObject)
SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)

Establece el valor de la propiedad IndexBasedLayoutOrientation.

(Heredado de Layout)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia en dependencyObject.

(Heredado de DependencyObject)
UninitializeForContext(LayoutContext)

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

(Heredado de Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

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

(Heredado de VirtualizingLayout)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancela una notificación de cambio registrada anteriormente mediante una llamada a RegisterPropertyChangedCallback.

(Heredado de DependencyObject)

Eventos

ArrangeInvalidated

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

(Heredado de Layout)
MeasureInvalidated

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

(Heredado de Layout)

Se aplica a

Consulte también