UniformGridLayout Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Positionne les éléments de façon séquentielle de gauche à droite ou de haut en bas dans une disposition d’encapsulage.

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

Héritage

Object IInspectable DependencyObject Layout VirtualizingLayout UniformGridLayout

Attributs

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

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez ItemsRepeater.

Ouvrez l’application Galerie WinUI 3 et voyez itemsRepeater en action.

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

L’exemple suivant montre comment définir la propriété ItemsRepeater.Layout sur 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>

Remarques

Les éléments sont décalés dans l’ordre de gauche à droite lorsque l’orientation est Horizontalet de haut en bas lorsque l’orientation est Vertical.

Chaque élément d’un UniformGridLayout est dimensionné de façon égale.

UniformGridLayout prend en charge la virtualisation lorsqu’il est attaché à un hôte qui prend en charge la virtualisation.

Constructeurs

UniformGridLayout()

Initialise une nouvelle instance de la classe UniformGridLayout.

Propriétés

Dispatcher	Retourne null toujours dans une application SDK d'application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le DispatcherQueue auquel cet objet est associé. DispatcherQueue représente une installation qui peut accéder au DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
IndexBasedLayoutOrientation	Obtient l’orientation, le cas échéant, dans laquelle les éléments sont disposés en fonction de leur index dans la collection source. (Hérité de Layout)
ItemsJustification	Obtient ou définit une valeur qui indique comment les éléments sont alignés sur l’axe sans défilement ou sans virtualisation.
ItemsJustificationProperty	Identifie la propriété de dépendance ItemsJustification .
ItemsStretch	Obtient ou définit une valeur qui indique comment les éléments sont dimensionnés pour remplir l’espace disponible.
ItemsStretchProperty	Identifie la propriété de dépendance ItemsStretch .
MaximumRowsOrColumns	Obtient ou définit le nombre maximal d’éléments rendus par ligne ou colonne, en fonction de l’orientation de UniformGridLayout.
MaximumRowsOrColumnsProperty	Identifie la propriété de dépendance MaximumRowsOrColumns .
MinColumnSpacing	Obtient ou définit l’espace minimal entre les éléments sur l’axe horizontal.
MinColumnSpacingProperty	Identifie la propriété de dépendance MinColumnSpacing .
MinItemHeight	Obtient ou définit la hauteur minimale de chaque élément.
MinItemHeightProperty	Identifie la propriété de dépendance MinItemHeight .
MinItemWidth	Obtient ou définit la largeur minimale de chaque élément.
MinItemWidthProperty	Identifie la propriété de dépendance MinItemWidth .
MinRowSpacing	Obtient ou définit l’espace minimal entre les éléments sur l’axe vertical.
MinRowSpacingProperty	Identifie la propriété de dépendance MinRowSpacing .
Orientation	Obtient ou définit l’axe le long duquel les éléments sont disposés.
OrientationProperty	Identifie la propriété de dépendance Orientation .

Méthodes

Arrange(LayoutContext, Size)	Positionne les éléments enfants et détermine une taille pour un conteneur UIElement. Les éléments de conteneur qui prennent en charge les dispositions jointes doivent appeler cette méthode à partir de leurs implémentations de remplacement de disposition pour former une mise à jour de disposition récursive. (Hérité de Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	En cas d’implémentation dans une classe dérivée, fournit le comportement de la passe « Arranger » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « Arrange ». (Hérité de VirtualizingLayout)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
CreateDefaultItemTransitionProvider()	Positionne les éléments de façon séquentielle de gauche à droite ou de haut en bas dans une disposition d’encapsulage. (Hérité de Layout)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject. (Hérité de DependencyObject)
InitializeForContext(LayoutContext)	Initialise n’importe quel état par conteneur requis par la disposition lorsqu’elle est attachée à un conteneur UIElement. (Hérité de Layout)
InitializeForContextCore(VirtualizingLayoutContext)	En cas de substitution dans une classe dérivée, initialise tout état par conteneur requis par la disposition lorsqu’elle est attachée à un conteneur UIElement. (Hérité de VirtualizingLayout)
InvalidateArrange()	Invalide l’état d’organisation (disposition) pour tous les conteneurs UIElement qui référencent cette disposition. Après l’invalidation, la disposition de l’élément UIElement est mise à jour, ce qui se produit de manière asynchrone. (Hérité de Layout)
InvalidateMeasure()	Invalide l’état de mesure (disposition) pour tous les conteneurs UIElement qui référencent cette disposition. (Hérité de Layout)
Measure(LayoutContext, Size)	Suggère un DesiredSize pour un élément conteneur. Un élément conteneur qui prend en charge les dispositions jointes doit appeler cette méthode à partir de leurs propres implémentations MeasureOverride pour former une mise à jour de disposition récursive. La disposition jointe doit appeler la mesure pour chacun des enfants UIElement du conteneur. (Hérité de Layout)
MeasureOverride(VirtualizingLayoutContext, Size)	Fournit le comportement de la passe « Mesure » du cycle de disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « Measure ». (Hérité de VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	Avertit la disposition lorsque la collection de données affectée à l’élément conteneur (ItemsSource) a changé. (Hérité de VirtualizingLayout)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject)
SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)	Définit la valeur de la propriété IndexBasedLayoutOrientation. (Hérité de Layout)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
UninitializeForContext(LayoutContext)	Supprime tout état de la disposition précédemment stockée sur le conteneur UIElement. (Hérité de Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	En cas de substitution dans une classe dérivée, supprime tout état de la disposition précédemment stockée sur le conteneur UIElement. (Hérité de VirtualizingLayout)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Événements

ArrangeInvalidated	Se produit lorsque l’état de l’organisation (disposition) a été invalidé. (Hérité de Layout)
MeasureInvalidated	Se produit lorsque l’état de mesure (disposition) a été invalidé. (Hérité de Layout)

Voir aussi

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• Vue d’ensemble d’UniformGridLayout