VirtualizingLayoutContext.GetOrCreateElementAt Méthode
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.
Surcharges
| GetOrCreateElementAt(Int32) |
Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié. Par défaut, si un élément existe déjà, il est retourné ; sinon, un nouvel élément est créé. 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). |
| GetOrCreateElementAt(Int32, ElementRealizationOptions) |
Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié à l’aide des options spécifiées. 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). |
GetOrCreateElementAt(Int32)
Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié. Par défaut, si un élément existe déjà, il est retourné ; sinon, un nouvel élément est créé.
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).
public:
virtual UIElement ^ GetOrCreateElementAt(int index) = GetOrCreateElementAt;/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
UIElement GetOrCreateElementAt(int const& index);[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
public UIElement GetOrCreateElementAt(int index);Public Function GetOrCreateElementAt (index As Integer) As UIElementParamètres
- index
-
Int32
int
Index de l’élément de données pour lequel récupérer un UIElement.
Retours
UiElement qui représente l’élément de données.
- Attributs
Remarques
Cette méthode appelle GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) avec des options définies sur None.
GetElementAtCore doit être implémenté dans une classe dérivée.
S’applique à
GetOrCreateElementAt(Int32, ElementRealizationOptions)
Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié à l’aide des options spécifiées.
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).
public:
virtual UIElement ^ GetOrCreateElementAt(int index, ElementRealizationOptions options) = GetOrCreateElementAt;/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
UIElement GetOrCreateElementAt(int const& index, ElementRealizationOptions const& options);[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
public UIElement GetOrCreateElementAt(int index, ElementRealizationOptions options);Public Function GetOrCreateElementAt (index As Integer, options As ElementRealizationOptions) As UIElementParamètres
- index
-
Int32
int
Index de l’élément de données pour lequel récupérer un UIElement.
- options
- ElementRealizationOptions
Valeur elementRealizationOptions qui spécifie s’il faut supprimer le recyclage automatique de l’élément récupéré ou forcer la création d’un nouvel élément.
Retours
UiElement qui représente l’élément de données.
- Attributs
Remarques
Cette méthode appelle GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) qui doit être implémenté dans une classe dérivée.
Lorsque vous demandez un élément pour l’index spécifié, vous pouvez éventuellement spécifier s’il faut supprimer le recyclage automatique de l’élément récupéré ou forcer la création d’un nouvel élément. Les éléments récupérés avec le recyclage automatique supprimé (SuppressAutoRecycle) sont ignorés par la logique de recyclage automatique qui efface les éléments réalisés qui n’ont pas été récupérés dans le cadre de la passe de disposition actuelle. Vous devez recycler explicitement ces éléments en les transmettant à la méthode RecycleElement pour éviter les fuites de mémoire.
Ces options sont destinées à des dispositions plus avancées qui choisissent de gérer explicitement la réalisation et le recyclage d’éléments comme optimisation des performances.