Compartilhar via

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

  • Artigo

Recupera um subconjunto de intervalo de texto que tem o valor de atributo de texto especificado.

Sintaxe

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID        attr,
  [in]          VARIANT                val,
  [in]          BOOL                   backward,
  [out, retval] IUIAutomationTextRange **found
);

Parâmetros

[in] attr

Tipo: TEXTATTRIBUTEID

O identificador do atributo de texto para o subconjunto de intervalo de texto que está sendo recuperado. Para obter uma lista de IDs de atributo de texto, consulte Identificadores de atributo de texto.

[in] val

Tipo: VARIANT

O valor do atributo. Esse valor deve corresponder ao tipo especificado para o atributo.

[in] backward

Tipo: BOOL

TRUE se o último intervalo de texto que ocorre deve ser retornado em vez do primeiro; caso contrário , FALSE.

[out, retval] found

Tipo: IUIAutomationTextRange**

Recebe um ponteiro para o intervalo de texto com um atributo e um valor de atributo correspondentes; caso contrário , NULL.

Retornar valor

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 FindAttribute recupera o texto correspondente, independentemente de o texto ficar oculto ou visível. Use UIA_IsHiddenAttributeId para marcar visibilidade do texto.

Requisitos

Requisito Valor
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 (include UIAutomation.h)

Confira também

IUIAutomationTextRange

suporte Automação da Interface do Usuário para conteúdo textual