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

Récupère la valeur de l’attribut de texte spécifié dans la plage de texte.

Syntaxe

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *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.

[out, retval] pRetVal

Type : VARIANT*

Reçoit l’un des éléments suivants.

• Adresse d’un objet représentant la valeur de l’attribut spécifié. Le type de données de la valeur varie en fonction de l’attribut spécifié. Par exemple, si attributeId est UIA_FontNameAttributeId, GetAttributeValue retourne une chaîne qui représente le nom de police de la plage de texte, mais si attributeId est UIA_IsItalicAttributeId, GetAttributeValue renvoie une valeur booléenne.
• Adresse de la valeur récupérée par la fonction UiaGetReservedMixedAttributeValue , si la valeur de l’attribut spécifié varie sur la plage de texte.
• Adresse de la valeur récupérée par la fonction UiaGetReservedNotSupportedValue , si l’attribut spécifié n’est pas pris en charge par le fournisseur ou le contrôle.

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 GetAttributeValue doit récupérer la valeur de l’attribut, que le texte soit masqué ou visible.

Configuration requise

Voir aussi

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation