Metodo ITextRangeProvider::GetAttributeValue (uiautomationcore.h)

  • Articolo

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

Sintassi

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

Parametri

[in] attributeId

Tipo: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Tipo: VARIANT*

Riceve una delle opzioni seguenti.

  • Indirizzo di un oggetto che rappresenta il valore dell'attributo specificato. Il tipo di dati del valore varia a seconda dell'attributo specificato. Ad esempio, se attributeId è UIA_FontNameAttributeId, GetAttributeValue restituisce una stringa che rappresenta il nome del tipo di carattere dell'intervallo di testo, ma se attributeId è UIA_IsItalicAttributeId, GetAttributeValue restituisce un valore booleano.
  • Indirizzo del valore recuperato dalla funzione UiaGetReservedMixedAttributeValue , se il valore dell'attributo specificato varia in base all'intervallo di testo.
  • Indirizzo del valore recuperato dalla funzione UiaGetReservedNotSupportedValue , se l'attributo specificato non è supportato dal provider o dal controllo.
Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

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

Commenti

Il metodo GetAttributeValue deve recuperare il valore dell'attributo indipendentemente dal fatto che il testo sia nascosto o visibile.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (include UIAutomation.h)

Vedi anche

Informazioni concettuali

ITextProvider

ITextRangeProvider

Riferimento

Cenni preliminari sui provider di automazione interfaccia utente