DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Méthode

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

Recycle un élément UIElement précédemment récupéré à l’aide de GetElement.

void RecycleElement(ElementFactoryRecycleArgs const& args);
public void RecycleElement(ElementFactoryRecycleArgs args);
function recycleElement(args)
Public Sub RecycleElement (args As ElementFactoryRecycleArgs)

Paramètres

args
ElementFactoryRecycleArgs

Instance d’ElementFactoryRecycleArgs.

Implémente

RecycleElement(ElementFactoryRecycleArgs)

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Remarques

La méthode RecycleElement est utilisée pour mettre de côté un élément en vue d’une réutilisation ultérieure, mais ne réinitialise pas automatiquement l’état actuel de l’élément. Par exemple, si l’arrière-plan d’un contrôle est défini par programmation, la valeur persiste lorsqu’elle est à nouveau ajoutée à l’arborescence dynamique.

Les éléments recyclés retournés par GetElement peuvent être ajoutés à l’arborescence dynamique de la même manière que les éléments nouvellement créés.

GetElement tente de récupérer un instance existant de ceux qui ont été recyclés. Si aucun n’est trouvé, il crée un instance à l’aide de LoadContent.

Le recyclage d’un élément peut ne pas entraîner sa suppression immédiate de l’arborescence d’éléments dynamiques. Dans ce cas, les événementsUnloaded Loaded ne sont pas déclenchés/, sauf s’ils sont ajoutés à un autre élément parent dans l’arborescence dynamique.

La spécification du parent n’est pas obligatoire lors de l’appel de RecycleElement. Toutefois, son utilisation est recommandée pour permettre une optimisation des performances. Lorsque GetElement est appelé avec une valeur Parent , il recherche les éléments recyclés pour ce même parent. S’ils sont toujours attachés à l’élément parent, ils peuvent être réutilisés sans entraîner la surcharge supplémentaire liée à la re-parentation de l’élément.

Notes

RecycleElement n’exclut pas automatiquement l’élément recyclé de participer à l’ordre de tabulation. Elle ne masque pas non plus l’affichage de l’homologue Automation de l’élément dans l’arborescence d’automatisation. Les contrôles de virtualisation intégrés de la plateforme gèrent cela pour les éléments sous leur contrôle.

Si vous créez un contrôle de virtualisation personnalisé à partir de zéro ou que vous appelez RecycleElement dans des scénarios ponctuels, sachez qu’il est de votre responsabilité d’exclure les éléments recyclés de l’ordre de tabulation et de l’arborescence des homologues d’automatisation.

Vous pouvez remplacer GetChildrenInTabFocusOrder et fournir le sous-ensemble d’éléments réalisés que l’infrastructure doit utiliser pour le focus Tab. De même, l’homologue d’automatisation du contrôle doit remplacer son GetChildrenCore et exclure les éléments recyclés.

S’applique à

Voir aussi