VirtualizingLayout Classe

Définition

Représente la classe de base d’un objet qui dimensionne et organise les éléments enfants d’un hôte et prend en charge la 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).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class VirtualizingLayout : Layout
/// [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 VirtualizingLayout : Layout
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[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 VirtualizingLayout : Layout
[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 VirtualizingLayout : Layout
Public Class VirtualizingLayout
Inherits Layout
Héritage
VirtualizingLayout
Dérivé
Attributs
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Exemples

Conseil

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

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).

Remarques

VirtualizingLayout est la classe de base pour les dispositions qui prennent en charge la virtualisation. Vous pouvez utiliser l’une des classes dérivées fournies ou en hériter pour créer votre propre disposition. Les classes de disposition de virtualisation concrètes fournies sont StackLayout et UniformGridLayout.

Constructeurs

VirtualizingLayout()

Initialise une nouvelle instance de la classe VirtualizingLayout .

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 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.

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 « Arranger » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passage « 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).

InitializeForContext(LayoutContext)

Initialise n’importe quel é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 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).

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.

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 doit 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 passage « 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).

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).

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 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).

Événements

ArrangeInvalidated

Se produit lorsque l’état de l’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)

S’applique à