UniformGridLayout Classe

Definizione

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.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
Ereditarietà
Attributi
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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)

Si applica a

Vedi anche