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. 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 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
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
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 |
|---|---|
|
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. |
|
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 |
|
Habilita a função de gancho especificada no membro lpfnHook |
|
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 |
|
Se definido ao inicializar uma caixa de diálogo Localizar Localizar, ocultará os botões de opção de direção da pesquisa. |
|
Se definido ao inicializar um |
|
Se definido ao inicializar um Localizar ou Substituir caixa de diálogo, ocultará a caixa de seleção Corresponder Somente Palavra Inteira. |
|
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 |
|
Se definido ao inicializar uma caixa de diálogo Localizar |
|
Se definido ao inicializar uma caixa de diálogo Localizar |
|
Se definido ao inicializar um Localizar ou Substituir caixa de diálogo, desabilita a caixa de seleção Word Inteiro. |
|
Se definido em uma mensagem |
|
Se definido em uma mensagem |
|
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. |
|
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 |
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
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
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
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
de referência de
ShowWindow