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 façon séquentielle de gauche à droite ou de haut en bas dans une disposition d’encapsulage.
/// [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
- Héritage
- Attributs
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
Exemples
Conseil
Pour plus d’informations, des conseils de conception et des exemples de code, consultez ItemsRepeater.
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.
<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 décalés dans l’ordre de gauche à droite lorsque l’orientation est Horizontal
et 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 |
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 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é |
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) |