Méthode ITextRangeProvider ::FindAttribute (uiautomationcore.h)

Retourne un sous-ensemble de plage de texte qui a la valeur d’attribut de texte spécifiée.

Syntaxe

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Paramètres

[in] attributeId

Type : TEXTATTRIBUTEID

Identificateur de l’attribut text. Pour obtenir la liste des ID d’attributs de texte, consultez Identificateurs d’attributs de texte.

[in] val

Type : VARIANT

Valeur d'attribut à rechercher. Cette valeur doit correspondre au type spécifié pour l'attribut.

[in] backward

Type : BOOL

TRUE si la dernière plage de texte doit être retournée au lieu de la première ; sinon , FALSE.

[out, retval] pRetVal

Type : ITextRangeProvider**

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. Les clients peuvent utiliser UIA_IsHiddenAttributeId pour case activée la visibilité du texte.

Configuration requise

Voir aussi

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation