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	Commdlg.h (inclua Windows.h)
Nomes Unicode e ANSI	FINDMSGSTRINGW (Unicode) e FINDMSGSTRINGA (ANSI)

Confira também

Referência

FINDREPLACE

Registerwindowmessage

Conceitual

Biblioteca de caixas de diálogo comuns