IUIAutomationTextRange::GetAttributeValue, méthode (uiautomationclient.h)

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

Syntaxe

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Paramètres

[in] attr

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] value

Type : VARIANT*

Reçoit la valeur de l’attribut spécifié.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le type de valeur récupérée par cette méthode dépend du paramètre attr . Par exemple, l’appel de GetAttributeValue avec le paramètre attr défini sur UIA_FontNameAttributeId renvoie une chaîne qui représente le nom de police de la plage de texte, tandis que l’appel de GetAttributeValue avec attr défini sur UIA_IsItalicAttributeId renvoie une valeur booléenne.

Si l’attribut spécifié par attr n’est pas pris en charge, le paramètre value reçoit une valeur équivalente à la propriété IUIAutomation::ReservedNotSupportedValue .

Une plage de texte peut inclure plusieurs valeurs pour un attribut particulier. Par exemple, si une plage de texte comprend plusieurs polices, l’attribut FontName a plusieurs valeurs. Un attribut avec plusieurs valeurs est appelé attribut mixte. Vous pouvez déterminer si un attribut particulier est un attribut mixte en comparant la valeur récupérée à partir de GetAttributeValue avec la propriété UIAutomation::ReservedMixedAttributeValue .

La méthode GetAttributeValue récupère la valeur de l’attribut, que le texte soit masqué ou visible. Utilisez UIA_ IsHiddenAttributeId pour case activée la visibilité du texte.

Configuration requise

Voir aussi

IUIAutomationTextRange

Prise en charge d’UI Automation pour le contenu textuel