A função ReplaceText cria uma caixa de diálogo sem janela restrita system-defined que permite que o usuário especifique uma Cadeia de Caracteres parPesquisarr por uma Cadeia de caracteres de substituição, como opções para controlar o localizar e substituir operações.
(HWND ReplaceText 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 a caixa de diálogo ou fechá-lo.
Se a função falhar, o valor de retorno é NULL. Para obter informações de erro estendidas, chamar o CommDlgExtendedError função, que pode retornar uma do seguinte códigos de erro:
| CDERR_FINDRESFAILURE | CDERR_MEMLOCKFAILURE |
| CDERR_INITIALIZATION | CDERR_NOHINSTANCE |
| CDERR_LOADRESFAILURE | CDERR_NOHOOK |
| CDERR_LOADSTRFAILURE | CDERR_NOTEMPLATE |
| CDERR_LOCKRESFAILURE | CDERR_STRUCTSIZE |
| CDERR_MEMALLOCFAILURE | FRERR_BUFFERLENGTHZERO |
A função ReplaceText não executa uma operação de substituição de texto. 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 ReplaceText, 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 nos botões Localizar próxima, substituir ou substituir tudo, ou quando a caixa de diálogo está fechando. O lParam parâmetro de uma mensagem FINDMSGSTRING contém um ponteiro para a 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 Substituir , 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. O IsDialogMessage função retorna um valor que indica se a caixa de diálogo Substituir processado a mensagem.
Você pode fornecer um procedimento de gancho de FRHookProc para uma caixa de diálogo Substituir . 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, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG