Méthode IUIAutomationTextRange ::FindAttribute (uiautomationclient.h)
Récupère un sous-ensemble de plage de texte qui a la valeur d’attribut de texte spécifiée.
Syntaxe
HRESULT FindAttribute(
[in] TEXTATTRIBUTEID attr,
[in] VARIANT val,
[in] BOOL backward,
[out, retval] IUIAutomationTextRange **found
);
Paramètres
[in] attr
Type : TEXTATTRIBUTEID
Identificateur de l’attribut de texte pour le sous-ensemble de plage de texte récupéré. Pour obtenir la liste des ID d’attribut de texte, consultez Identificateurs d’attribut de texte.
[in] val
Type : VARIANT
Valeur de l'attribut. Cette valeur doit correspondre au type spécifié pour l'attribut.
[in] backward
Type : BOOL
TRUE si la dernière plage de texte en cours doit être retournée au lieu de la première ; sinon , FALSE.
[out, retval] found
Type : IUIAutomationTextRange**
Reçoit un pointeur vers la plage de texte avec un attribut et une valeur d’attribut correspondants ; sinon NULL.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La méthode FindAttribute récupère le texte correspondant, que le texte soit masqué ou visible. Utilisez UIA_IsHiddenAttributeId pour case activée la visibilité du texte.
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) |