IUIAutomation ::GetRootElement, méthode (uiautomationclient.h)
Récupère l’élément UI Automation qui représente le bureau.
Syntaxe
HRESULT GetRootElement(
[out, retval] IUIAutomationElement **root
);
Paramètres
[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 au sein de 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 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) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour