Método ITextRangeProvider::GetAttributeValue (uiautomationcore.h)

Recupera o valor do atributo de texto especificado no intervalo de texto.

Sintaxe

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

[in] attributeId

Tipo: TEXTATTRIBUTEID

O identificador do atributo de texto. Para obter uma lista de IDs de atributo de texto, consulte Identificadores de atributo de texto.

[out, retval] pRetVal

Recebe um dos itens a seguir.

O endereço de um objeto que representa o valor do atributo especificado. O tipo de dados do valor varia dependendo do atributo especificado. Por exemplo, se attributeId for UIA_FontNameAttributeId, GetAttributeValue retornará uma cadeia de caracteres que representa o nome da fonte do intervalo de texto, mas se attributeId for UIA_IsItalicAttributeId, GetAttributeValue retornará um booliano.
O endereço do valor recuperado pela função UiaGetReservedMixedAttributeValue , se o valor do atributo especificado variar em relação ao intervalo de texto.
O endereço do valor recuperado pela função UiaGetReservedNotSupportedValue , se o atributo especificado não tiver suporte do provedor ou do controle.

Este parâmetro é passado não inicializado.

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

O método GetAttributeValue deve recuperar o valor do atributo, independentemente de o texto estar oculto ou visível.


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcore.h (include UIAutomation.h)