Compartilhar via


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
FR_DIALOGTERM
0x00000040
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.
FR_DOWN
0x00000001
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.
FR_ENABLEHOOK
0x00000100
Habilita a função de gancho especificada no membro lpfnHook . Esse sinalizador é usado apenas para inicializar a caixa de diálogo.
FR_ENABLETEMPLATE
0x00000200
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.
FR_ENABLETEMPLATEHANDLE
0x00002000
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.
FR_FINDNEXT
0x00000008
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.
FR_HIDEUPDOWN
0x00004000
Se definido ao inicializar uma caixa de diálogo Localizar , ocultará os botões de opção de direção de pesquisa.
FR_HIDEMATCHCASE
0x00008000
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.
FR_HIDEWHOLEWORD
0x00010000
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, ocultará a caixa de diálogo Corresponder Word Inteiro Somente marcar.
FR_MATCHCASE
0x00000004
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.
FR_NOMATCHCASE
0x00000800
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, desabilita a caixa marcar Desabilitar Maiúsculas e Minúsculas.
FR_NOUPDOWN
0x00000400
Se definido ao inicializar uma caixa de diálogo Localizar , desabilita os botões de opção de direção de pesquisa.
FR_NOWHOLEWORD
0x00001000
Se definido ao inicializar uma caixa de diálogo Localizar ou Substituir, desabilita a caixa marcar Word Inteira.
FR_REPLACE
0x00000010
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.
FR_REPLACEALL
0x00000020
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.
FR_SHOWHELP
0x00000080
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 .
FR_WHOLEWORD
0x00000002
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

FRHookProc

Findtext

MAKEINTRESOURCE

Referência

Replacetext

Showwindow

WM_INITDIALOG