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

Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationTextRange

Prise en charge d’UI Automation pour le contenu textuel