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

Récupère l’élément parent de l’élément UI Automation spécifié et met en cache les propriétés et les modèles de contrôle.

Syntaxe

HRESULT GetParentElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **parent
);

Paramètres

[in] element

Type : IUIAutomationElement*

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

[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] parent

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément parent ou NULL s’il n’existe aucun élément parent.

Valeur retournée

Type : HRESULT

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

Remarques

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 qu’élément parent soit retourné en tant que parent lors des passes ultérieures.

Configuration requise

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