Metodo IUIAutomationTextRange::GetAttributeValue (uiautomationclient.h)

Articolo
08/26/2023

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


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (includere UIAutomation.h)

Vedi anche

IUIAutomationTextRange

Automazione interfaccia utente supporto per il contenuto testuale

Condividi tramite