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
);

Parâmetros

[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

Tipo: VARIANT*

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.

Valor retornado

Tipo: HRESULT

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

Comentários

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

Requisitos

Confira também

Conceitual

ITextProvider

ITextRangeProvider

Referência

Visão Geral dos Provedores de Automação de Interface do Usuário