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

Article
08/26/2023

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


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Share via