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

  • Article

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

   
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)