Estrutura FINDREPLACEA (commdlg.h)
Contém informações que as funções FindText e ReplaceText usam para inicializar as caixas de diálogo Localizar e Substituir . A mensagem registrada FINDMSGSTRING usa essa estrutura para passar a entrada de pesquisa ou substituição do usuário para a janela do proprietário de uma caixa de diálogo Localizar ou Substituir .
Sintaxe
typedef struct tagFINDREPLACEA {
DWORD lStructSize;
HWND hwndOwner;
HINSTANCE hInstance;
DWORD Flags;
LPSTR lpstrFindWhat;
LPSTR lpstrReplaceWith;
WORD wFindWhatLen;
WORD wReplaceWithLen;
LPARAM lCustData;
LPFRHOOKPROC lpfnHook;
LPCSTR lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;
Membros
lStructSize
Tipo: DWORD
O comprimento, em bytes, da estrutura .
hwndOwner
Digite: HWND
Um identificador para a janela que possui a caixa de diálogo. O procedimento de janela da janela especificada recebe mensagens FINDMSGSTRING da caixa de diálogo. Esse membro pode ser qualquer identificador de janela válido, mas não deve ser NULL.
hInstance
Tipo: HINSTANCE
Se o sinalizador FR_ENABLETEMPLATEHANDLE estiver definido nos Sinalizadores, hInstance será um identificador para um objeto de memória que contém um modelo de caixa de diálogo. Se o sinalizador FR_ENABLETEMPLATE estiver definido, hInstance será um identificador para um módulo que contém um modelo de caixa de diálogo chamado pelo membro lpTemplateName . Se nenhum sinalizador for definido, esse membro será ignorado.
Flags
Tipo: DWORD
Um conjunto de sinalizadores de bits que você pode usar para inicializar a caixa de diálogo. A caixa de diálogo define esses sinalizadores quando envia a mensagem registrada FINDMSGSTRING para indicar a entrada do usuário. Esse membro pode ser um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
Se definido em uma mensagem FINDMSGSTRING , indica que a caixa de diálogo está fechando. Quando você recebe uma mensagem com esse sinalizador definido, o identificador da caixa de diálogo retornado pela função FindText ou ReplaceText não é mais válido. |
|
Se definido, o botão Para baixo dos botões de opção de direção em uma caixa de diálogo Localizar é selecionado indicando que você deve pesquisar do local atual até o final do documento. Se não estiver definido, o botão Para cima será selecionado, portanto, você deverá pesquisar até o início do documento. Você pode definir esse sinalizador para inicializar a caixa de diálogo. Se definido em uma mensagem FINDMSGSTRING , indica a seleção do usuário. |
|
Habilita a função de gancho especificada no membro lpfnHook . Esse sinalizador é usado apenas para inicializar a caixa de diálogo. |
|
Indica que os membros hInstance e lpTemplateName especificam um modelo de caixa de diálogo a ser usado no lugar do modelo padrão. Esse sinalizador é usado apenas para inicializar a caixa de diálogo. |
|
Indica que o membro hInstance identifica um bloco de dados que contém um modelo de caixa de diálogo pré-carregado. O sistema ignorará o membro lpTemplateName se esse sinalizador for especificado. |
|
Se definido em uma mensagem FINDMSGSTRING , indica que 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. |
|
Se definido ao inicializar uma caixa de diálogo Localizar , ocultará os botões de opção de direção de pesquisa. |
|
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, ocultará a caixa de marcar De Correspondência de Maiúsculas e Minúsculas. |
|
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, ocultará a caixa de diálogo Corresponder Word Inteiro Somente marcar. |
|
Se definido, a caixa Marcar de Correspondência de Maiúsculas e Minúsculas será selecionada indicando que a pesquisa deve diferenciar maiúsculas de minúsculas. Se não estiver definida, a caixa marcar será desmarcada, portanto, a pesquisa não diferencia maiúsculas de minúsculas. Você pode definir esse sinalizador para inicializar a caixa de diálogo. Se definido em uma mensagem FINDMSGSTRING , indica a seleção do usuário. |
|
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, desabilita a caixa marcar Desabilitar Maiúsculas e Minúsculas. |
|
Se definido ao inicializar uma caixa de diálogo Localizar , desabilita os botões de opção de direção de pesquisa. |
|
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, desabilita a caixa marcar Word Inteira. |
|
Se definido em uma mensagem FINDMSGSTRING , indica que 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. |
|
Se definido em uma mensagem FINDMSGSTRING , indica que 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. |
|
Faz com que a caixa de diálogo exiba o botão Ajuda . O membro hwndOwner deve especificar a janela para receber as mensagens registradas HELPMSGSTRING que a caixa de diálogo envia quando o usuário clica no botão Ajuda . |
|
Se definido, a caixa Corresponder Word Somente marcar será selecionada indicando que você deve pesquisar apenas palavras inteiras que correspondam à cadeia de caracteres de pesquisa. Se não estiver definida, a caixa marcar será desmarcada, portanto, você também deve pesquisar fragmentos de palavra que correspondam à cadeia de caracteres de pesquisa. Você pode definir esse sinalizador para inicializar a caixa de diálogo. Se definido em uma mensagem FINDMSGSTRING , indica a seleção do usuário. |
lpstrFindWhat
Tipo: LPTSTR
A cadeia de caracteres de pesquisa que o usuário digitou no controle de edição Localizar. Você deve alocar dinamicamente o buffer ou usar uma matriz global ou estática para que ele não saia do escopo antes que a caixa de diálogo seja fechada. O buffer deve ter pelo menos 80 caracteres. Se o buffer contiver uma cadeia de caracteres quando você inicializar a caixa de diálogo, a cadeia de caracteres será exibida no controle de edição Localizar. Se uma mensagem FINDMSGSTRING especificar o sinalizador FR_FINDNEXT , lpstrFindWhat conterá a cadeia de caracteres a ser pesquisada. Os sinalizadores FR_DOWN, FR_WHOLEWORD e FR_MATCHCASE indicam a direção e o tipo de pesquisa. Se uma mensagem FINDMSGSTRING especificar os sinalizadores FR_REPLACE ou FR_REPLACE , lpstrFindWhat conterá a cadeia de caracteres a ser substituída.
lpstrReplaceWith
Tipo: LPTSTR
A cadeia de caracteres de substituição que o usuário digitou no controle de edição Substituir por . Você deve alocar dinamicamente o buffer ou usar uma matriz global ou estática para que ele não saia do escopo antes que a caixa de diálogo seja fechada. Se o buffer contiver uma cadeia de caracteres quando você inicializar a caixa de diálogo, a cadeia de caracteres será exibida no controle de edição Substituir por .
Se uma mensagem FINDMSGSTRING especificar os sinalizadores FR_REPLACE ou FR_REPLACEALL , lpstrReplaceWith conterá a cadeia de caracteres de substituição .
A função FindText ignora esse membro.
wFindWhatLen
Tipo: WORD
O comprimento, em bytes, do buffer apontado pelo membro lpstrFindWhat .
wReplaceWithLen
Tipo: WORD
O comprimento, em bytes, do buffer apontado pelo membro lpstrReplaceWith .
lCustData
Tipo: LPARAM
Dados definidos pelo aplicativo que o sistema passa para o procedimento de gancho identificado pelo membro lpfnHook . Quando o sistema envia a mensagem WM_INITDIALOG para o procedimento de gancho, o parâmetro lParam da mensagem é um ponteiro para a estrutura FINDREPLACE especificada quando a caixa de diálogo foi criada. O procedimento de gancho pode usar esse ponteiro para obter o valor lCustData .
lpfnHook
Tipo: LPFRHOOKPROC
Um ponteiro para um procedimento de gancho FRHookProc que pode processar mensagens destinadas à caixa de diálogo. Esse membro é ignorado, a menos que o sinalizador FR_ENABLEHOOK seja definido no membro Flags . Se o procedimento de gancho retornar FALSE em resposta à mensagem WM_INITDIALOG , o procedimento de gancho deverá exibir a caixa de diálogo ou então a caixa de diálogo não será mostrada. Para fazer isso, primeiro execute qualquer outra operação de pintura e, em seguida, chame as funções ShowWindow e UpdateWindow .
lpTemplateName
Tipo: LPCTSTR
O nome do recurso de modelo da caixa de diálogo no módulo identificado pelo membro hInstance . Esse modelo é substituído pelo modelo de caixa de diálogo padrão. Para recursos de caixa de diálogo numerados, esse pode ser um valor retornado pela macro MAKEINTRESOURCE . Esse membro é ignorado, a menos que o sinalizador FR_ENABLETEMPLATE seja definido no membro Flags .
Comentários
Observação
O cabeçalho commdlg.h define FINDREPLACE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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) |
Confira também
Biblioteca de caixas de diálogo comuns
Conceitual
Referência
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de