IUIAutomationTreeWalker::NormalizeElementBuildCache, méthode (uiautomationclient.h)

Récupère l’élément ancêtre le plus proche de l’élément Microsoft UI Automation spécifié dans l’arborescence, préréfète les propriétés et les modèles de contrôle demandés, puis stocke les éléments prérécupérés dans le cache.

Syntaxe

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

Paramètres

[in] element

Type : IUIAutomationElement*

Pointeur vers l’élément à partir duquel démarrer la normalisation.

[in] cacheRequest

Type : IUIAutomationCacheRequest*

Pointeur vers une demande de cache qui spécifie les propriétés et les modèles de contrôle à mettre en cache sur l’élément retourné.

[out, retval] normalized

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément ancêtre le plus proche de l’élément spécifié dans l’arborescence.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’élément est normalisé en parcourant la chaîne ancêtre dans l’arborescence jusqu’à ce qu’un élément qui remplit la condition d’affichage (spécifiée par un appel précédent à IUIAutomationTreeWalker::Condition) soit atteint. Si l’élément racine est atteint, l’élément racine est retourné, même s’il ne remplit pas la condition d’affichage.

Cette méthode est utile pour les applications qui obtiennent des références à des éléments UI Automation par test de positionnement. L’application peut vouloir travailler uniquement avec des types d’éléments spécifiques, et peut utiliser IUIAutomationTreeWalker::NormalizeElement pour s’assurer que, quel que soit l’élément initialement récupéré (par exemple, lorsqu’une barre de défilement obtient le focus d’entrée), seul l’élément d’intérêt (tel qu’un élément de contenu) est finalement récupéré.

Configuration requise