UniformGridLayout Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Positionne les éléments de manière séquentielle de gauche à droite ou de haut en bas dans une disposition d’habillage.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application 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

Héritage

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.

Les applications WinUI 3 Gallery et WinUI 2 Gallery incluent des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 3 et WinUI 2.

Si elles sont déjà installées, ouvrez-les en cliquant sur les liens suivants : WinUI 3 Gallery ou WinUI 2 Gallery.

Si elles ne sont pas installées, vous pouvez télécharger WinUI 3 Gallery et WinUI 2 Gallery à partir du Microsoft Store.

Vous pouvez également obtenir le code source des deux applications à partir de GitHub (utilisez la branche main pour WinUI 3 et la branche winui2 pour WinUI 2).

L’exemple suivant montre comment définir la propriété ItemsRepeater.Layout sur un 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 retardés dans l’ordre de gauche à droite lorsque l’orientation est Horizontal, et retardés 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’elle est attachée à un hôte qui prend en charge la virtualisation.

Constructeurs

UniformGridLayout()

Initialise une nouvelle instance de la classe UniformGridLayout . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

ItemsJustification	Obtient ou définit une valeur qui indique comment les éléments sont alignés sur l’axe de non-défilement ou de non virtualisation. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsJustificationProperty	Identifie la propriété de dépendance ItemsJustification . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsStretch	Obtient ou définit une valeur qui indique la taille des éléments pour remplir l’espace disponible. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ItemsStretchProperty	Identifie la propriété de dépendance ItemsStretch . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaximumRowsOrColumns	Obtient ou définit le nombre maximal d’éléments rendus par ligne ou colonne, en fonction de l’orientation de UniformGridLayout. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaximumRowsOrColumnsProperty	Identifie la propriété de dépendance MaximumRowsOrColumns . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinColumnSpacing	Obtient ou définit l’espace minimal entre les éléments de l’axe horizontal. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinColumnSpacingProperty	Identifie la propriété de dépendance MinColumnSpacing . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinItemHeight	Obtient ou définit la hauteur minimale de chaque élément. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinItemHeightProperty	Identifie la propriété de dépendance MinItemHeight . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinItemWidth	Obtient ou définit la largeur minimale de chaque élément. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinItemWidthProperty	Identifie la propriété de dépendance MinItemWidth . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinRowSpacing	Obtient ou définit l’espace minimal entre les éléments de l’axe vertical. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinRowSpacingProperty	Identifie la propriété de dépendance MinRowSpacing . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Orientation	Obtient ou définit l’axe le long duquel les éléments sont disposés. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
OrientationProperty	Identifie la propriété de dépendance Orientation . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Méthodes

Arrange(LayoutContext, Size)	Positionne les éléments enfants et détermine une taille pour un UIElement de conteneur. 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. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	En cas d’implémentation dans une classe dérivée, fournit le comportement de la passe de disposition « Arrange ». Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ». Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de VirtualizingLayout)
InitializeForContext(LayoutContext)	Initialise tout état par conteneur nécessaire à la disposition lorsqu’elle est attachée à un conteneur UIElement. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (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. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (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, uiElement aura sa disposition mise à jour, ce qui se produit de manière asynchrone. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de Layout)
InvalidateMeasure()	Invalide l’état de mesure (disposition) pour tous les conteneurs UIElement qui référencent cette disposition. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (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 est censée appeler la mesure pour chacun des enfants UIElement du conteneur. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (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 passe « Measure ». Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (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é. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de VirtualizingLayout)
UninitializeForContext(LayoutContext)	Supprime tout état de la disposition précédemment stockée sur le conteneur UIElement. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	En cas de substitution dans une classe dérivée, supprime tout état précédemment stocké sur le conteneur UIElement. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de VirtualizingLayout)

Événements

ArrangeInvalidated	Se produit lorsque l’état d’organisation (disposition) a été invalidé. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de Layout)
MeasureInvalidated	Se produit lorsque l’état de mesure (disposition) a été invalidé. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows). (Hérité de Layout)

Voir aussi

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• Vue d’ensemble de UniformGridLayout