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.
Este parâmetro é passado não inicializado.

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

   
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)

Confira também

Conceitual

ITextProvider

ITextRangeProvider

Referência

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