UiaFind, fonction (uiautomationcoreapi.h)
Syntaxe
HRESULT UiaFind(
[in] HUIANODE hnode,
[in] UiaFindParams *pParams,
[in] UiaCacheRequest *pRequest,
[out] SAFEARRAY **ppRequestedData,
[out] SAFEARRAY **ppOffsets,
[out] SAFEARRAY **ppTreeStructures
);
Paramètres
[in] hnode
Type : HUIANODE
Nœud à utiliser comme point de départ de la recherche.
[in] pParams
Type : UiaFindParams*
Adresse d’une structure UiaFindParams qui contient les paramètres de recherche.
[in] pRequest
Type : UiaCacheRequest*
Adresse d’une structure UiaCacheRequest qui spécifie les informations à mettre en cache.
[out] ppRequestedData
Type : SAFEARRAY**
Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY contenant les données demandées. Ce paramètre est passé sans être initialisé. Consultez la section Notes.
[out] ppOffsets
Type : SAFEARRAY**
Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY contenant les index vers le tableau de données demandé pour l’endroit où commence la sous-arborescence de l’élément. Ce paramètre est passé sans être initialisé.
[out] ppTreeStructures
Type : SAFEARRAY**
Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY contenant la description de l’arborescence. Ce paramètre est passé sans être initialisé. Consultez la section Notes.
Valeur de retour
Type : HRESULT
Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.
Remarques
L’arborescence est décrite par une chaîne où chaque caractère est « p » ou « ». Le premier caractère de la chaîne représente toujours le nœud racine. La chaîne est NULL si aucun élément n’est retourné par la fonction .
Un « p » représente un nœud (élément UI Automation). Lorsqu’un « p » suit directement un autre, le deuxième nœud est un enfant du premier. Un « ) représente un pas en arrière dans l’arborescence. Par exemple, « pp)p » représente un nœud suivi de deux nœuds enfants qui sont frères l’un de l’autre. Dans « pp))p », le dernier nœud est un frère du premier.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | uiautomationcoreapi.h |
Bibliothèque | Uiautomationcore.lib |
DLL | Uiautomationcore.dll |
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