IUIAutomationElement ::FindFirst, méthode (uiautomationclient.h)
Récupère le premier élément enfant ou descendant qui correspond à la condition spécifiée.
Syntaxe
HRESULT FindFirst(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[out, retval] IUIAutomationElement **found
);
Paramètres
scope
[in] condition
Type : IUIAutomationCondition*
Pointeur vers une condition qui représente les critères à respecter.
[out, retval] found
Type : IUIAutomationElement**
Reçoit un pointeur vers l’élément. Null est retourné si aucun élément correspondant n’est trouvé.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
L’étendue de la recherche est relative à l’élément sur lequel la méthode est appelée. Les éléments sont retournés dans l’ordre dans lequel ils ont été rencontrés dans l’arborescence.
Cette fonction ne peut pas rechercher des éléments ancêtres dans l’arborescence Microsoft UI Automation ; autrement dit, TreeScope_Ancestors n’est pas une valeur valide pour le paramètre d’étendue.
Lorsque vous recherchez des fenêtres de niveau supérieur sur le bureau, veillez à spécifier TreeScope_Children dans le paramètre d’étendue , 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.
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.
Cette fonction ignore les éléments de l’arborescence brute. Appelez FindFirstBuildCache pour rechercher dans l’arborescence brute en spécifiant le TreeScope approprié sur l’IUIAutomationCacheRequest passé à cette fonction.
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
Conceptuel
Obtention d'éléments UI Automation
Référence
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