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.
Ce paramètre est passé sans être initialisé.

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

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation