IUIAutomationTreeWalker::NormalizeElement, 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.

Syntaxe

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Paramètres

[in] element

Type : IUIAutomationElement*

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

[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. Mais tout d’abord, l’élément réussi est testé pour voir s’il correspond à une condition de normalisation. Si tel est le cas, l’élément passé est retourné, même s’il ne s’agit pas d’un ancêtre.

La méthode retourne UIA_E_ELEMENTNOTAVAILABLE si aucun élément correspondant n’a été trouvé.

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::Normalize 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 (par exemple, un élément de contenu) est finalement récupéré.

Configuration requise