Interface IUIAutomationTreeWalker (uiautomationclient.h)

Expose les propriétés et méthodes que UI Automation applications clientes utilisent pour afficher et parcourir les éléments UI Automation sur le bureau.

Héritage

L’interface IUIAutomationTreeWalker hérite de l’interface IUnknown. IUIAutomationTreeWalker a également les types de membres suivants :

Méthodes

L’interface IUIAutomationTreeWalker possède ces méthodes.

IUIAutomationTreeWalker ::get_Condition Récupère la condition qui définit l’affichage de l’arborescence UI Automation.
IUIAutomationTreeWalker ::GetFirstChildElement Récupère le premier élément enfant de l’élément UI Automation spécifié.
IUIAutomationTreeWalker ::GetFirstChildElementBuildCache 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.
IUIAutomationTreeWalker ::GetLastChildElement Récupère le dernier élément enfant de l’élément UI Automation spécifié.
IUIAutomationTreeWalker ::GetLastChildElementBuildCache Récupère le dernier é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.
IUIAutomationTreeWalker ::GetNextSiblingElement Récupère l’élément frère suivant de l’élément UI Automation spécifié.
IUIAutomationTreeWalker ::GetNextSiblingElementBuildCache Récupère l’élément frère suivant de l’élément UI Automation spécifié et met en cache les propriétés et les modèles de contrôle.
IUIAutomationTreeWalker ::GetParentElement Récupère l’élément parent de l’élément UI Automation spécifié.
IUIAutomationTreeWalker ::GetParentElementBuildCache 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.
IUIAutomationTreeWalker ::GetPreviousSiblingElement Récupère l’élément frère précédent de l’élément UI Automation spécifié.
IUIAutomationTreeWalker ::GetPreviousSiblingElementBuildCache Récupère l’élément frère précédent de l’élément UI Automation spécifié et met en cache les propriétés et les modèles de contrôle.
IUIAutomationTreeWalker ::NormalizeElement Récupère l’élément ancêtre le plus proche de l’élément Microsoft UI Automation spécifié dans l’arborescence.
IUIAutomationTreeWalker ::NormalizeElementBuildCache Récupère l’élément ancêtre le plus proche de l’élément Microsoft UI Automation spécifié dans l’arborescence, 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.

Remarques

UI Automation clients affichent les éléments sur le bureau sous la forme d’un ensemble d’objets IUIAutomation organisés dans une arborescence. À l’aide de l’interface IUIAutomationTreeWalker , une application cliente peut naviguer en sélectionnant une vue de l’arborescence et en passant d’un élément à un autre dans une direction spécifiée à l’aide de méthodes telles que GetFirstChildElement et GetNextSiblingElement.

La navigation dans l’arborescence à l’aide de IUIAutomationTreeWalker peut entraîner des appels inter-processus et n’est pas aussi efficace que la localisation d’un élément à l’aide des méthodes IUIAutomationElement ::FindAll ou IUIAutomationElement ::FindFirst .

Si votre application cliente peut essayer de trouver des éléments dans sa propre interface utilisateur, vous devez effectuer tous les appels UI Automation sur un thread distinct.

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

CreateTreeWalker

interfaces d’éléments UI Automation pour les clients