Compartilhar via


Estrutura FINDREPLACEW (commdlg.h)

Contém informações que as funções FindText e ReplaceText usam para inicializar as caixas de diálogo Localizar e Substituir. O FINDMSGSTRING mensagem registrada 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 tagFINDREPLACEW {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPWSTR       lpstrFindWhat;
  LPWSTR       lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCWSTR      lpTemplateName;
} FINDREPLACEW, *LPFINDREPLACEW;

Membros

lStructSize

Tipo: DWORD

O comprimento, em bytes, da estrutura.

hwndOwner

Tipo: 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 de FR_ENABLETEMPLATEHANDLE estiver definido noFlags, hInstance será um identificador para um objeto de memória que contém um modelo de caixa de diálogo. Se o sinalizador de FR_ENABLETEMPLATE estiver definido, hInstance será um identificador para um módulo que contém um modelo de caixa de diálogo nomeado pelo membro lpTemplateName. Se nenhum dos sinalizadores estiver 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 o FINDMSGSTRING mensagem registrada 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 conjunto de sinalizadores, 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 será selecionado indicando que você deve pesquisar do local atual até o final do documento. Se não estiver definido, o botão Up será selecionado para que você pesquise 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 Localizar, ocultará os botões de opção de direção da pesquisa.
FR_HIDEMATCHCASE
0x00008000
Se definido ao inicializar um Localizar ou Substituir caixa de diálogo, ocultará a caixa de seleção Caso de Correspondência.
FR_HIDEWHOLEWORD
0x00010000
Se definido ao inicializar um Localizar ou Substituir caixa de diálogo, ocultará a caixa de seleção Corresponder Somente Palavra Inteira.
FR_MATCHCASE
0x00000004
Se definido, a caixa de seleção Caso de Correspondência será selecionada indicando que a pesquisa deve diferenciar maiúsculas de minúsculas. Se não estiver definido, a caixa de seleção não será selecionada, 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 Localizar ou Substituir, desabilita a caixa de seleção Caso de Correspondência.
FR_NOUPDOWN
0x00000400
Se definido ao inicializar uma caixa de diálogo Localizar , desabilita os botões de opção de direção da pesquisa.
FR_NOWHOLEWORD
0x00001000
Se definido ao inicializar um Localizar ou Substituir caixa de diálogo, desabilita a caixa de seleção Word Inteiro.
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 Todos os 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 o HELPMSGSTRING mensagens registradas que a caixa de diálogo envia quando o usuário clica no botão Ajuda.
FR_WHOLEWORD
0x00000002
Se definido, a caixa de seleção Corresponder Somente Word Inteiro será selecionada indicando que você deve pesquisar apenas palavras inteiras que correspondam à cadeia de caracteres de pesquisa. Se não estiver definido, a caixa de seleção será desmarcada, portanto, você também deve procurar 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 o que. 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 ao inicializar a caixa de diálogo, a cadeia de caracteres será exibida no controle de edição Localizar o que. Se uma mensagem FINDMSGSTRING especificar o sinalizador FR_FINDNEXT, lpstrFindWhat conterá a cadeia de caracteres a ser pesquisada. Os sinalizadores FR_DOWN, FR_WHOLEWORDe 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 ao 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 FRHookProc procedimento de gancho que pode processar mensagens destinadas à caixa de diálogo. Esse membro é ignorado, a menos que o sinalizador de FR_ENABLEHOOK seja definido no membro sinalizadores do . 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 outras operações 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 do hInstance. Esse modelo é substituído pelo modelo de caixa de diálogo padrão. Para recursos da caixa de diálogo numerada, esse pode ser um valor retornado pela macro MAKEINTRESOURCE. Esse membro é ignorado, a menos que o sinalizador de FR_ENABLETEMPLATE seja definido no membro sinalizadores do .

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho commdlg.h (inclua Windows.h)

Consulte também

da Biblioteca de Caixas de Diálogo Comuns

Conceitual

FRHookProc

FindText

MAKEINTRESOURCE

de referência de

ReplaceText

ShowWindow

WM_INITDIALOG