A função FindText cria uma sem janela restrita pelo sistema caixa de diálogo Procurar que permite que o usuário especifique uma Cadeia de caracteres para pesquisar para e opções para usar ao pesquisar para texto em um documento.
(HWND FindText LPFINDREPLACE lpfr / / ponteiro para estrutura com inicialização / / dados);
Se a função for bem-sucedido, o valor de retorno é o identificador de janela para a caixa de diálogo. Você pode usar o identificador de janela para se comunicar com ou para fechar a caixa de diálogo.
Se a função falhar, o valor de retorno é NULL. Para obter informações de erro estendidas, chame o CommDlgExtendedError função. CommDlgExtendedError pode retornar uma do seguinte códigos de erro:
| CDERR_FINDRESFAILURE | CDERR_MEMLOCKFAILURE |
| CDERR_INITIALIZATION | CDERR_NOHINSTANCE |
| CDERR_LOCKRESFAILURE | CDERR_NOHOOK |
| CDERR_LOADRESFAILURE | CDERR_NOTEMPLATE |
| CDERR_LOADSTRFAILURE | CDERR_STRUCTSIZE |
| CDERR_MEMALLOCFAILURE | FRERR_BUFFERLENGTHZERO |
A função FindText não executa uma operação de pesquisa. Em vez disso, a caixa de diálogo envia mensagens FINDMSGSTRING registrado para o procedimento 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 identifica a janela do proprietário.
Antes de chamar FindText, você deve chamar o RegisterWindowMessage função para obter o identificador para a mensagem FINDMSGSTRING. O procedimento caixa diálogo usa esse identificador para enviar mensagens quando o usuário clica no botãoAvançar Localizar, ou quando a caixa de diálogo está fechando. O lParam parâmetro da mensagem FINDMSGSTRING contém um ponteiro para uma estrutura FINDREPLACE . Sinalizadores 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 , você também deve usar o IsDialogMessage função no loop de mensagem principal do seu aplicativo para garantir que a caixa de diálogo processa correctamente entrada do teclado, tais como as teclas tab e esc. IsDialogMessage retorna um valor que indica se a caixa de diálogo Localizar processado a mensagem.
Você pode fornecer um procedimento de gancho de FRHookProc para uma caixa de diálogo Localizar . O procedimento de gancho pode Processoar as mensagens enviadas para a caixa de diálogo. Para habilitar um procedimento de gancho, defina o sinalizador FR_ENABLEHOOK in o sinalizadores membro da estrutura FINDREPLACE e especificar o endereço do procedimento de gancho na lpfnHook membro.
nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.
Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText