Metodo IUIAutomationTextRange::GetAttributeValue (uiautomationclient.h)

Recupera il valore dell'attributo di testo specificato nell'intero intervallo di testo.

Sintassi

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

Parametri

[in] attr

Tipo: TEXTATTRIBUTEID

Identificatore dell'attributo di testo. Per un elenco di ID attributo di testo, vedere Identificatori di attributo di testo.

[out, retval] value

Tipo: VARIANT*

Riceve il valore dell'attributo specificato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il tipo di valore recuperato da questo metodo dipende dal parametro attr . Ad esempio, chiamando GetAttributeValue con il parametro attr impostato su UIA_FontNameAttributeId restituisce una stringa che rappresenta il nome del tipo di carattere dell'intervallo di testo, mentre chiama GetAttributeValue con attr impostato su UIA_IsItalicAttributeId restituisce un booleano.

Se l'attributo specificato da attr non è supportato, il parametro value riceve un valore equivalente alla proprietà IUIAutomation::ReservedNotSupportedValue .

Un intervallo di testo può includere più di un valore per un determinato attributo. Ad esempio, se un intervallo di testo include più tipi di carattere, l'attributo FontName avrà più valori. Un attributo con più di un valore viene chiamato attributo misto. È possibile determinare se un determinato attributo è un attributo misto confrontando il valore recuperato da GetAttributeValue con la proprietà UIAutomation::ReservedMixedAttributeValue .

Il metodo GetAttributeValue recupera il valore dell'attributo indipendentemente dal fatto che il testo sia nascosto o visibile. Usare UIA_ IsHiddenAttributeId per controllare la visibilità del testo.

Requisiti

Vedi anche

IUIAutomationTextRange

Automazione interfaccia utente supporto per il contenuto testuale