UniformGridLayout Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Positionne les éléments de manière séquentielle de gauche à droite ou de haut en bas dans une disposition de création de package de restrictions.
/// [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- Héritage
- Attributs
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
Exemples
Tip
Pour plus d’informations, des conseils de conception et des exemples de code, consultez ItemsRepeater.
L’application WinUI 3 Gallery inclut des exemples interactifs de la plupart des contrôles, des caractéristiques et des fonctionnalités de WinUI 3. Obtenez l’application à partir du Microsoft Store ou obtenez le code source sur GitHub.
L’exemple suivant montre comment définir la propriété ItemsRepeater.Layout sur un UniformGridLayout.
<ItemsRepeater ItemsSource="{x:Bind Items}"
ItemTemplate="{StaticResource MyTemplate}">
<ItemsRepeater.Layout>
<UniformGridLayout MinItemWidth="200"
MinColumnSpacing="28"
ItemsJustification="SpaceAround"/>
</ItemsRepeater.Layout>
</ItemsRepeater>
Remarques
Les éléments sont retardés dans l’ordre de gauche à droite lorsque l’orientation est Horizontal, et retardés en 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
| Nom | Description |
|---|---|
| UniformGridLayout() |
Initialise une nouvelle instance de la classe UniformGridLayout . |
Propriétés
| Nom | Description |
|---|---|
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| 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 de non-défilement ou de non virtualisation. |
| ItemsJustificationProperty |
Identifie la propriété de dépendance ItemsJustification . |
| ItemsStretch |
Obtient ou définit une valeur qui indique la taille des éléments 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 de 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 de 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
| Nom | Description |
|---|---|
| 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. (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 ». (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 manière séquentielle de gauche à droite ou de haut en bas dans une disposition de création de package de restrictions. (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 DependencyObject. (Hérité de DependencyObject) |
| InitializeForContext(LayoutContext) |
Initialise tout état par conteneur dont la disposition a besoin 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 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, uiElement aura sa disposition mise à jour, 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 est censée 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 passe « 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 à une dependencyProperty spécifique sur cette instance DependencyObject . (Hérité de DependencyObject) |
| SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation) |
Définit la valeur de la |
| 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 disposition précédemment stocké sur le conteneur UIElement. (Hérité de Layout) |
| UninitializeForContextCore(VirtualizingLayoutContext) |
En cas de substitution dans une classe dérivée, supprime tout état de disposition précédemment stocké sur le conteneur UIElement. (Hérité de VirtualizingLayout) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |
Événements
| Nom | Description |
|---|---|
| ArrangeInvalidated |
Se produit lorsque l’état d’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) |