IUIAutomation ::GetRootElementBuildCache, méthode (uiautomationclient.h)

Récupère l’élément UI Automation qui représente le bureau, préfète les propriétés et les modèles de contrôle demandés, et stocke les éléments prédéfinis dans le cache.

Syntaxe

HRESULT GetRootElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **root
);

Paramètres

[in] cacheRequest

Type : IUIAutomationCacheRequest*

Pointeur vers la demande de cache, qui spécifie les propriétés et les modèles de contrôle à stocker dans le cache.

[out, retval] root

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément UI Automation.

Valeur retournée

Type : HRESULT

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

Remarques

Vous pouvez utiliser l’élément racine comme point de départ pour rechercher d’autres éléments, à l’aide des méthodes FindAll et FindFirst .

Lorsque vous effectuez une recherche à partir de l’élément racine, veillez à spécifier TreeScope_Children dans l’étendue de la recherche, et non TreeScope_Descendants. Une recherche dans l’ensemble de la sous-arborescence du bureau peut itérer à travers des milliers d’éléments et entraîner un dépassement de capacité de la pile.

Configuration requise

Voir aussi

IUIAutomation

IUIAutomation ::GetRootElement