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

Artigo
03/03/2024

Retorna um subconjunto do intervalo de texto que contém o texto especificado.

Sintaxe

HRESULT FindText(
  [in]          BSTR               text,
  [in]          BOOL               backward,
  [in]          BOOL               ignoreCase,
  [out, retval] ITextRangeProvider **pRetVal
);

Parâmetros

[in] text

Tipo: BSTR

A cadeia de caracteres de texto a ser pesquisada.

[in] backward

Tipo: BOOL

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

[in] ignoreCase

Tipo: BOOL

TRUE se o caso deve ser ignorado; caso contrário , FALSE.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Recebe um ponteiro para o intervalo de texto correspondente ao texto especificado; caso contrário , NULL. Este parâmetro é passado não inicializado.

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

Não há diferenciação entre texto oculto e visível.

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)