Função FindTextA (commdlg.h)
Cria uma caixa de diálogo Localizar sem formatação definida pelo sistema que permite que o usuário especifique uma cadeia de caracteres a ser pesquisada 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.
Retornar valor
Digite: 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 com 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:
Comentários
A função FindText não executa uma operação de pesquisa. Em vez disso, a caixa de diálogo envia mensagens registradas FINDMSGSTRING para o procedimento de janela da janela proprietário da caixa de diálogo. Quando você cria a caixa de diálogo, o membro hwndOwner 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 membro Flags 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 main 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 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 FR_ENABLEHOOK no membro Flags da estrutura FINDREPLACE e especifique o endereço do procedimento de gancho no membro lpfnHook .
Exemplos
Para obter um exemplo, consulte Localizando texto.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | commdlg.h (inclua Windows.h) |
| Biblioteca | Comdlg32.lib |
| DLL | Comdlg32.dll |
| Conjunto de APIs | ext-ms-win-shell-comdlg32-l1-1-1 (introduzido no Windows 10, versão 10.0.14393) |
Confira também
Biblioteca de caixas de diálogo comuns
Conceitual
Referência