Partager via


IUIAutomationElement7 ::FindFirstWithOptionsBuildCache, méthode (uiautomationclient.h)

Recherche le premier élément correspondant dans l’ordre spécifié, mais met également en cache ses propriétés et son modèle.

Syntaxe

HRESULT FindFirstWithOptionsBuildCache(
  [in]           TreeScope                 scope,
  [in]           IUIAutomationCondition    *condition,
  [in]           IUIAutomationCacheRequest *cacheRequest,
                 TreeTraversalOptions      traversalOptions,
  [in, optional] IUIAutomationElement      *root,
  [out, retval]  IUIAutomationElement      **found
);

Paramètres

[in] scope

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

[in] condition

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

[in] cacheRequest

Pointeur vers une demande de cache qui spécifie les modèles de contrôle et les propriétés à inclure dans le cache.

traversalOptions

Valeur d’énumération spécifiant l’ordre de navigation dans l’arborescence.

[in, optional] root

Pointeur vers l’élément avec lequel commencer la recherche.

[out, retval] found

Reçoit un pointeur vers l’élément. NULL est retournée si aucun élément correspondant n’est trouvé.

Valeur de retour

Retourne S_OK en cas de réussite, sinon un HRESULT code d’erreur.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1703 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2016 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête uiautomationclient.h (include UIAutomation.h)
DLL UIAutomationCore.dll

Voir aussi

IUIAutomationElement7