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

  • Article

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

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

Voir aussi

IUIAutomation

IUIAutomation ::GetRootElement