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

Artigo
03/09/2024

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

Sintaxe

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **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.

[in] val

Tipo: VARIANT

O valor de atributo a ser pesquisado. 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] pRetVal

Tipo: ITextRangeProvider**

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 ser oculto ou visível. Os clientes podem usar UIA_IsHiddenAttributeId para marcar visibilidade do texto.

Requisitos

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