UniformGridLayout Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 : VirtualizingLayoutPublic 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) |