Antes de criar uma caixa de diálogo Localizar ou Substituir , você deve chamar o RegisterWindowMessage função para obter um identificador de mensagem para mensagem registrada FINDMSGSTRING . Você pode usar o identificador para detectar e processar mensagens enviadas da caixa de diálogo. Quando o usuário clica a Localizar próxima, Substituirou Substituir tudo botão em uma caixa de diálogo, o procedimento caixa diálogo envia uma mensagem FINDMSGSTRING para o procedimento janela da janela de proprietário. Quando você cria a caixa de diálogo, o hwndOwner membro da estrutura FINDREPLACE identifica a janela do proprietário.
O lParam parâmetro de uma mensagem FINDMSGSTRING é um ponteiro para a estrutura FINDREPLACE que você especificou ao criar a caixa de diálogo. Antes de enviar a mensagem, a caixa de diálogo define os membros dessa estrutura com o utilizador mais recente entrada, incluindo a Cadeia de caracteres para pesquisar para a Cadeia de caracteres de substituição (se houver) e opções para a operação de localizar e substituir.
Em uma mensagem FINDMSGSTRING, o sinalizadores membro da estrutura FINDREPLACE inclui um dos seguintes sinalizadores para indicar o evento que causou a mensagem.
| Bandeira | Significado |
|---|---|
| FR_DIALOGTERM | Fecha a caixa de diálogo. Depois que a janela do proprietário processa esta mensagem, o identificador da caixa de diálogo já não é válido. |
| FR_FINDNEXT | O usuário clicou o botão Procurar seguinte em uma caixa de diálogo Localizar ou Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres para pesquisar. |
| FR_REPLACE | O usuário clicou o botão Substituir na caixa de diálogo Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres para substituir e o membro lpstrReplaceWith especifica a Cadeia de caracteres de substituição. |
| FR_REPLACEALL | O usuário clicou no botão Substituir tudo na caixa de diálogo Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres para substituir e o membro lpstrReplaceWith especifica a Cadeia de caracteres de substituição. |
Para uma mensagem Localizar próxima ou Substituir tudo , sinalizadores membro pode incluir qualquer combinação do seguinte sinalizadores para indicar as opções de pesquisa.
| Bandeira | Significado |
|---|---|
| FR_DOWN | Se definido, o botão para baixo de botões de opção de direção é seleccionado, indicando que o usuário quer a pesquisa do local atual para o final do documento. Se FR_DOWN não estiver definido, o botão está selecionado para que o usuário deseja pesquisar para o início do documento. |
| FR_MATCHCASE | Se definido, a caixa de seleção Diferenciar maiúsculas de minúsculas está marcado, indicando que o usuário quer Pesquisarr para ser diferencia maiúscminúsc de minúsculas. Se FR_MATCHCASE não estiver definido, a caixa de seleção estiver desmarcada, assim que a pesquisa deve ser maiúsculas de minúsculas. |
| FR_WHOLEWORD | Se definido, a caixa de seleção Corresponder palavra inteira só está marcado, indicando que o usuário deseja pesquisar somente palavras inteiras que correspondem à string de pesquisa. Se FR_WHOLEWORD não estiver definido, a caixa de seleção estiver desmarcada, então você também deve procurar fragmentos de palavras que correspondem à string de pesquisa. |