Méthode IUIAutomationTextRange ::FindAttribute (uiautomationclient.h)

  • Article

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)

Voir aussi

IUIAutomationTextRange

UI Automation prise en charge du contenu textuel