Condividi tramite


UniformGridLayout Classe

Definizione

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

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

L'app WinUI 3 Gallery include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.

Nell'esempio seguente viene illustrato come impostare la proprietà ItemsRepeater.Layout su un oggetto UniformGridLayout.

<ItemsRepeater ItemsSource="{x:Bind Items}"
                    ItemTemplate="{StaticResource MyTemplate}">
    <ItemsRepeater.Layout>
        <UniformGridLayout MinItemWidth="200"
                                MinColumnSpacing="28"
                                ItemsJustification="SpaceAround"/>
    </ItemsRepeater.Layout>
</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 .

Proprietà

Dispatcher

Restituisce null sempre in un'app SDK per app di Windows. Usare invece DispatcherQueue .

(Ereditato da DependencyObject)
DispatcherQueue

Ottiene l'oggetto DispatcherQueue associato. Rappresenta DispatcherQueue una struttura che può accedere al thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia DependencyObject utente.

(Ereditato da DependencyObject)
IndexBasedLayoutOrientation

Ottiene l'orientamento, se presente, in cui gli elementi vengono disposti in base al relativo indice nell'insieme di origine.

(Ereditato da Layout)
ItemsJustification

Ottiene o imposta un valore che indica come gli elementi vengono allineati sull'asse non a scorrimento o non virtualizzato.

ItemsJustificationProperty

Identifica la proprietà di dipendenza ItemsJustification .

ItemsStretch

Ottiene o imposta un valore che indica la dimensione degli elementi per riempire lo spazio disponibile.

ItemsStretchProperty

Identifica la proprietà di dipendenza ItemsStretch .

MaximumRowsOrColumns

Ottiene o imposta il numero massimo di elementi sottoposti a rendering per riga o colonna, in base all'orientamento di UniformGridLayout.

MaximumRowsOrColumnsProperty

Identifica la proprietà di dipendenza MaximumRowsOrColumns .

MinColumnSpacing

Ottiene o imposta lo spazio minimo tra gli elementi sull'asse orizzontale.

MinColumnSpacingProperty

Identifica la proprietà di dipendenza MinColumnSpacing .

MinItemHeight

Ottiene o imposta l'altezza minima di ogni elemento.

MinItemHeightProperty

Identifica la proprietà di dipendenza MinItemHeight .

MinItemWidth

Ottiene o imposta la larghezza minima di ogni elemento.

MinItemWidthProperty

Identifica la proprietà di dipendenza MinItemWidth .

MinRowSpacing

Ottiene o imposta lo spazio minimo tra gli elementi sull'asse verticale.

MinRowSpacingProperty

Identifica la proprietà di dipendenza MinRowSpacing .

Orientation

Ottiene o imposta l'asse lungo cui sono disposti gli elementi.

OrientationProperty

Identifica la proprietà di dipendenza Orientamento .

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.

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

(Ereditato da VirtualizingLayout)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
CreateDefaultItemTransitionProvider()

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

(Ereditato da Layout)
GetAnimationBaseValue(DependencyProperty)

Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva.

(Ereditato da DependencyObject)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject.

(Ereditato da DependencyObject)
InitializeForContext(LayoutContext)

Inizializza qualsiasi stato per contenitore necessario quando è collegato a un contenitore UIElement.

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

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

(Ereditato da Layout)
InvalidateMeasure()

Invalida lo stato di misurazione (layout) per tutti i contenitori UIElement che fanno riferimento a questo layout.

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

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

(Ereditato da VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)

Notifica al layout quando la raccolta dati assegnata all'elemento contenitore (ItemsSource) è stata modificata.

(Ereditato da VirtualizingLayout)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se viene impostato un valore locale.

(Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica.

(Ereditato da DependencyObject)
SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)

Imposta il valore della proprietà IndexBasedLayoutOrientation.

(Ereditato da Layout)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject.

(Ereditato da DependencyObject)
UninitializeForContext(LayoutContext)

Rimuove qualsiasi stato archiviato in precedenza nel contenitore UIElement.

(Ereditato da Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

Quando sottoposto a override in una classe derivata, rimuove qualsiasi stato archiviato in precedenza nel contenitore UIElement.

(Ereditato da VirtualizingLayout)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)

Eventi

ArrangeInvalidated

Si verifica quando lo stato di disposizione (layout) è stato invalidato.

(Ereditato da Layout)
MeasureInvalidated

Si verifica quando lo stato di misurazione (layout) è stato invalidato.

(Ereditato da Layout)

Si applica a

Vedi anche