Mensagem FINDMSGSTRING
Uma caixa de diálogo Localizar ou Substituir envia a mensagem registrada FINDMSGSTRING para o procedimento de janela de sua janela de proprietário quando o usuário clica no botão Localizar Próximo, Substituir ou Substituir Tudo ou fecha a caixa de diálogo.
#define FINDMSGSTRING TEXT("commdlg_FindReplace")
Parâmetros
-
wParam
-
Este parâmetro não é usado.
-
lParam
-
Um ponteiro para uma estrutura FINDREPLACE . Os membros dessa estrutura contêm a entrada de usuário mais recente, incluindo a cadeia de caracteres a ser pesquisada, a cadeia de caracteres de substituição (se houver) e as opções de pesquisa e substituição.
Valor retornado
Esta mensagem não tem nenhum valor retornado.
Comentários
Você deve especificar a constante FINDMSGSTRING em uma chamada para a função RegisterWindowMessage para obter o identificador da mensagem enviada pela caixa de diálogo.
Ao criar a caixa de diálogo, use o membro hwndOwner da estrutura FINDREPLACE para identificar a janela para receber mensagens FINDMSGSTRING .
O membro Flags da estrutura FINDREPLACE inclui um dos sinalizadores a seguir para indicar o evento que causou a mensagem.
| Sinalizador | Significado |
|---|---|
| FR_DIALOGTERM (0x00000040) | A caixa de diálogo está fechando. Depois que a janela do proprietário processa essa mensagem, um identificador para a caixa de diálogo não é mais válido. |
| FR_FINDNEXT (0x00000008) | O usuário clicou no botão Localizar Próximo em uma caixa de diálogo Localizar ou Substituir . O membro lpstrFindWhat especifica a cadeia de caracteres a ser pesquisada. |
| FR_REPLACE (0x00000010) | O usuário clicou no botão Substituir em uma caixa de diálogo Substituir . O membro lpstrFindWhat especifica a cadeia de caracteres a ser substituída e o membro lpstrReplaceWith especifica a cadeia de caracteres de substituição. |
| FR_REPLACEALL (0x00000020) | O usuário clicou no botão Substituir Tudo em uma caixa de diálogo Substituir . O membro lpstrFindWhat especifica a cadeia de caracteres a ser substituída e o membro lpstrReplaceWith especifica a cadeia de caracteres de substituição. |
Para uma mensagem Localizar Próximo ou Substituir Tudo , o membro Flags pode incluir um ou mais dos sinalizadores a seguir para indicar as opções de pesquisa.
| Sinalizador | Significado |
|---|---|
| FR_DOWN (0x00000001) | Se definido, o botão Para baixo dos botões de opção de direção será selecionado indicando que o usuário deseja pesquisar do local atual até o final do documento. Se FR_DOWN não estiver definido, o botão Para cima será selecionado para que o usuário queira pesquisar até o início do documento. |
| FR_MATCHCASE (0x00000004) | Se definido, a caixa marcar de Correspondência de Maiúsculas e Minúsculas será selecionada indicando que o usuário deseja que a pesquisa diferencia maiúsculas de minúsculas. Se FR_MATCHCASE não estiver definido, a caixa de marcar será desmarcada, portanto, a pesquisa não diferencia maiúsculas de minúsculas. |
| FR_WHOLEWORD (0x00000002) | Se definido, a caixa Corresponder Word Somente marcar será selecionada indicando que o usuário deseja pesquisar apenas palavras inteiras que correspondam à cadeia de caracteres de pesquisa. Se FR_WHOLEWORD não estiver definido, a caixa de marcar será desmarcada, portanto, você também deverá pesquisar fragmentos de palavra que correspondam à cadeia de caracteres de pesquisa. |
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] |
| Cabeçalho |
|
| Nomes Unicode e ANSI |
FINDMSGSTRINGW (Unicode) e FINDMSGSTRINGA (ANSI) |
Confira também
-
Referência
-
Conceitual