UniformGridLayout Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Posiziona gli elementi in sequenza da sinistra a destra o in alto verso il basso in un layout di wrapping.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

/// [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.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

Ereditarietà

DependencyObject

Layout

VirtualizingLayout

UniformGridLayout

Attributi

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Esempio

Suggerimento

Per altre informazioni, indicazioni sulla progettazione e esempi di codice, vedere ItemsRepeater.

Le app WinUI 3 Gallery e WinUI 2 Gallery includono esempi interattivi della maggior parte dei controlli WinUI 3 e WinUI 2, delle funzionalità e delle funzionalità.

Se è già installato, aprirli facendo clic sui collegamenti seguenti: WinUI 3 Gallery o WinUI 2 Gallery.

Se non sono installati, è possibile scaricare la raccolta WinUI 3 e la raccolta WinUI 2 da Microsoft Store.

È anche possibile ottenere il codice sorgente per GitHub (usare il ramo principale per WinUI 3 e il ramo winui2 per WinUI 2).

Nell'esempio seguente viene illustrato come impostare la proprietà ItemsRepeater.Layout su un oggetto 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>

Commenti

Gli elementi vengono eseguiti in ordine da sinistra a destra quando l'orientamento è Horizontal, e vengono eseguiti in alto verso il basso quando l'orientamento è Vertical.

Ogni elemento in un UniformGridLayout è di dimensioni uguali.

UniformGridLayout supporta la virtualizzazione quando è collegata a un host che supporta la virtualizzazione.

Costruttori

UniformGridLayout()

Inizializza una nuova istanza della classe UniformGridLayout . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Proprietà

ItemsJustification	Ottiene o imposta un valore che indica come gli elementi vengono allineati sull'asse non a scorrimento o non virtualizzato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ItemsJustificationProperty	Identifica la proprietà di dipendenza ItemsJustification . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ItemsStretch	Ottiene o imposta un valore che indica la dimensione degli elementi per riempire lo spazio disponibile. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ItemsStretchProperty	Identifica la proprietà di dipendenza ItemsStretch . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MaximumRowsOrColumns	Ottiene o imposta il numero massimo di elementi sottoposti a rendering per riga o colonna, in base all'orientamento di UniformGridLayout. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MaximumRowsOrColumnsProperty	Identifica la proprietà di dipendenza MaximumRowsOrColumns . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinColumnSpacing	Ottiene o imposta lo spazio minimo tra gli elementi sull'asse orizzontale. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinColumnSpacingProperty	Identifica la proprietà di dipendenza MinColumnSpacing . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinItemHeight	Ottiene o imposta l'altezza minima di ogni elemento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinItemHeightProperty	Identifica la proprietà di dipendenza MinItemHeight . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinItemWidth	Ottiene o imposta la larghezza minima di ogni elemento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinItemWidthProperty	Identifica la proprietà di dipendenza MinItemWidth . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinRowSpacing	Ottiene o imposta lo spazio minimo tra gli elementi sull'asse verticale. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
MinRowSpacingProperty	Identifica la proprietà di dipendenza MinRowSpacing . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
Orientation	Ottiene o imposta l'asse lungo cui sono disposti gli elementi. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
OrientationProperty	Identifica la proprietà di dipendenza Orientamento . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Metodi

Arrange(LayoutContext, Size)	Posiziona gli elementi figlio e determina una dimensione per un contenitore UIElement. Gli elementi del contenitore che supportano layout collegati devono chiamare questo metodo dalle implementazioni di override del layout per formare un aggiornamento di layout ricorsivo. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	Quando implementato in una classe derivata, fornisce il comportamento per il passaggio di layout "Arrange". Le classi possono eseguire l'override di questo metodo per definire il proprio comportamento di passaggio "Arrange". Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da VirtualizingLayout)
InitializeForContext(LayoutContext)	Inizializza qualsiasi stato per contenitore necessario quando è collegato a un contenitore UIElement. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
InitializeForContextCore(VirtualizingLayoutContext)	Quando sottoposto a override in una classe derivata, inizializza qualsiasi stato per contenitore necessario quando viene collegato a un contenitore UIElement. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da VirtualizingLayout)
InvalidateArrange()	Invalida lo stato di disposizione (layout) per tutti i contenitori UIElement che fanno riferimento a questo layout. Dopo l'invalidazione, uiElement avrà il relativo layout aggiornato, che si verifica in modo asincrono. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
InvalidateMeasure()	Invalida lo stato di misurazione (layout) per tutti i contenitori UIElement che fanno riferimento a questo layout. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
Measure(LayoutContext, Size)	Suggerisce un oggetto DesiredSize per un elemento contenitore. Un elemento contenitore che supporta layout collegati deve chiamare questo metodo dalle proprie implementazioni di MeasureOverride per formare un aggiornamento di layout ricorsivo. Il layout collegato è previsto chiamare la misura per ognuno dei figli UIElement del contenitore. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
MeasureOverride(VirtualizingLayoutContext, Size)	Fornisce il comportamento per il passaggio "Measure" del ciclo di layout. Le classi possono eseguire l'override di questo metodo per definire il comportamento di passaggio "Measure". Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	Notifica al layout quando la raccolta dati assegnata all'elemento contenitore (ItemsSource) è stata modificata. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da VirtualizingLayout)
UninitializeForContext(LayoutContext)	Rimuove qualsiasi stato archiviato in precedenza nel contenitore UIElement. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	Quando sottoposto a override in una classe derivata, rimuove qualsiasi stato archiviato in precedenza nel contenitore UIElement. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da VirtualizingLayout)

Eventi

ArrangeInvalidated	Si verifica quando lo stato di disposizione (layout) è stato invalidato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)
MeasureInvalidated	Si verifica quando lo stato di misurazione (layout) è stato invalidato. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows). (Ereditato da Layout)

Vedi anche

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• Panoramica di UniformGridLayout