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

  • Article

Récupère le premier élément enfant de l’élément UI Automation spécifié.

Syntaxe

HRESULT GetFirstChildElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **first
);

Paramètres

[in] element

Type : IUIAutomationElement*

Pointeur vers l’élément pour lequel récupérer le premier enfant.

[out, retval] first

Type : IUIAutomationElement**

Reçoit un pointeur vers le premier élément enfant.

Valeur retournée

Type : HRESULT

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

Remarques

Un élément peut avoir des éléments enfants supplémentaires qui ne correspondent pas à la condition d’affichage actuelle et ne sont donc pas retournés lors de la navigation dans l’arborescence d’éléments.

La structure de l’arborescence microsoft UI Automation change à mesure que les éléments d’interface utilisateur visibles sur le bureau changent. Il n’est pas garanti qu’un élément retourné en tant que premier élément enfant soit retourné en tant que premier enfant lors des passes ultérieures.

Configuration requise

Condition requise Valeur
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)