IUIAutomationElement ::FindAll, méthode (uiautomationclient.h)

Article
08/08/2024

Retourne tous les éléments UI Automation qui répondent à la condition spécifiée.

Syntaxe

HRESULT FindAll(
  [in]          TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [out, retval] IUIAutomationElementArray **found
);

Paramètres

[in] scope

Type : TreeScope

Combinaison de valeurs spécifiant l’étendue de la recherche.

[in] condition

Type : IUIAutomationCondition*

Pointeur vers une condition qui représente les critères à mettre en correspondance.

[out, retval] found

Type : IUIAutomationElementArray**

Reçoit un pointeur vers un tableau d’éléments correspondants. Retourne un tableau vide si aucun élément correspondant n’est trouvé.

Valeur de retour

Type : HRESULT

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

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 sont rencontrés dans l’arborescence.

Cette fonction ne peut pas rechercher d’é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 l’étendue paramètre, 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 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement]
serveur minimum 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
d’en-tête	uiautomationclient.h (include UIAutomation.h)