Compartilhar via

Método IUIAutomationTextRange::GetAttributeValue (uiautomationclient.h)

  • Artigo

Recupera o valor do atributo de texto especificado em todo o intervalo de texto.

Sintaxe

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Parâmetros

[in] attr

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] value

Tipo: VARIANT*

Recebe o valor do atributo especificado.

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 tipo de valor recuperado por esse método depende do parâmetro attr . Por exemplo, chamar GetAttributeValue com o parâmetro attr definido como UIA_FontNameAttributeId retorna uma cadeia de caracteres que representa o nome da fonte do intervalo de texto, enquanto chamar GetAttributeValue com attr definido como UIA_IsItalicAttributeId retornaria um booleano.

Se não houver suporte para o atributo especificado por attr , o parâmetro value receberá um valor equivalente à propriedade IUIAutomation::ReservedNotSupportedValue .

Um intervalo de texto pode incluir mais de um valor para um atributo específico. Por exemplo, se um intervalo de texto incluir mais de uma fonte, o atributo FontName terá vários valores. Um atributo com mais de um valor é chamado de atributo misto. Você pode determinar se um atributo específico é um atributo misto comparando o valor recuperado de GetAttributeValue com a propriedade UIAutomation::ReservedMixedAttributeValue .

O método GetAttributeValue recupera o valor do atributo, independentemente de o texto ser oculto ou visível. Use UIA_ IsHiddenAttributeId para marcar visibilidade do texto.

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (inclua UIAutomation.h)

Confira também

IUIAutomationTextRange

Suporte à automação da interface do usuário para conteúdo textual