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

Récupère le premier élément enfant 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 GetFirstChildElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **first
);

Paramètres

[in] element

Type : IUIAutomationElement*

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

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

Type : IUIAutomationElement**

Reçoit un pointeur vers le premier élément enfant ou NULL s’il n’y a pas d’é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 des é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 suivantes.

Configuration requise