Compartilhar via


Função TextRange_FindText (uiautomationcoreapi.h)

Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Component Object Model) do Microsoft Automação da Interface do Usuário.
 
Retorna o primeiro intervalo de texto na direção especificada que contém o texto que o cliente está procurando.

Sintaxe

HRESULT TextRange_FindText(
  [in]  HUIATEXTRANGE hobj,
  [in]  BSTR          text,
  [in]  BOOL          backward,
  [in]  BOOL          ignoreCase,
  [out] HUIATEXTRANGE *pRetVal
);

Parâmetros

[in] hobj

Tipo: HUIATEXTRANGE

O intervalo de texto a ser pesquisado.

[in] text

Tipo: BSTR

A cadeia de caracteres a ser pesquisada.

[in] backward

Tipo: BOOL

TRUE para pesquisar para trás; caso contrário , FALSE.

[in] ignoreCase

Tipo: BOOL

TRUE para especificar uma pesquisa que não diferencia maiúsculas de minúsculas; caso contrário , FALSE.

[out] pRetVal

Tipo: HUITEXTRANGE*

Quando essa função retorna, contém o intervalo de texto para o primeiro intervalo de texto que corresponde à cadeia de caracteres que o cliente está procurando. Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll