Função FindTextA (commdlg.h)

Cria uma modelagem definida pelo sistema caixa de diálogo Localizar que permite que o usuário especifique uma cadeia de caracteres para pesquisar e opções a serem usadas ao pesquisar texto em um documento.

Sintaxe

HWND FindTextA(
  [in] LPFINDREPLACEA unnamedParam1
);

Parâmetros

[in] unnamedParam1

Tipo: LPFINDREPLACE

Um ponteiro para uma estrutura FINDREPLACE que contém informações usadas para inicializar a caixa de diálogo. A caixa de diálogo usa essa estrutura para enviar informações sobre a entrada do usuário para seu aplicativo. Para obter mais informações, consulte a seção Comentários a seguir.

Valor de retorno

Tipo: HWND

Se a função for bem-sucedida, o valor retornado será o identificador de janela para a caixa de diálogo. Você pode usar o identificador de janela para se comunicar ou fechar a caixa de diálogo.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame a função CommDlgExtendedError. CommDlgExtendedError pode retornar um dos seguintes códigos de erro:

Observações

A função FindText não executa uma operação de pesquisa. Em vez disso, a caixa de diálogo envia FINDMSGSTRING mensagens registradas para o procedimento de janela da janela do proprietário da caixa de diálogo. Quando você cria a caixa de diálogo, o hwndOwner membro da estrutura FINDREPLACE é um identificador para a janela do proprietário.

Antes de chamar FindText, você deve chamar a função RegisterWindowMessage para obter o identificador da mensagem FINDMSGSTRING. O procedimento da caixa de diálogo usa esse identificador para enviar mensagens quando o usuário clica no botão Localizar Próximo ou quando a caixa de diálogo está fechando. O parâmetro lParam da mensagem FINDMSGSTRING contém um ponteiro para uma estrutura FINDREPLACE. O Flags membro dessa estrutura indica o evento que causou a mensagem. Outros membros da estrutura indicam a entrada do usuário.

Se você criar uma caixa de diálogo Localizar, também deverá usar a função IsDialogMessage no loop de mensagem principal do aplicativo para garantir que a caixa de diálogo processe corretamente a entrada do teclado, como as teclas TAB e ESC. IsDialogMessage retorna um valor que indica se a caixa de diálogo Localizar processou a mensagem.

Você pode fornecer um procedimento de gancho de FRHookProc para uma caixa de diálogo Localizar. O procedimento de gancho pode processar mensagens enviadas para a caixa de diálogo. Para habilitar um procedimento de gancho, defina o sinalizador de FR_ENABLEHOOK no Flags membro da estrutura FINDREPLACE e especifique o endereço do procedimento de gancho no membro lpfnHook .

Exemplos

Para obter um exemplo, consulte Localizandode Texto.

Nota

O cabeçalho commdlg.h define FindText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commdlg.h (inclua Windows.h)
biblioteca	Comdlg32.lib
de DLL	Comdlg32.dll
conjunto de API	ext-ms-win-shell-comdlg32-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

CommDlgExtendedError

da Biblioteca de Caixas de Diálogo Comuns

Conceitual

FINDMSGSTRING

FINDREPLACE

FRHookProc

isDialogMessage

de referência de

RegisterWindowMessage

ReplaceText