FINDREPLACE

A estrutura FINDREPLACE contém informações que o FindText e ReplaceText funções usam para inicializar os Localizar e Substituir caixas de diálogo comuns. A mensagem registrada FINDMSGSTRING usa essa estrutura para passar de pesquisa do usuário ou entrada de substituição para a janela de proprietário de uma caixa de diálogo comum Localizar ou Substituir.

typedef struct {/ / fr DWORD lStructSize; 
    HWND hwndOwner; 
    HINSTANCE hInstance; 
    DWORD Sinalizadores; 
    LPTSTR lpstrFindWhat; 
    LPTSTR lpstrReplaceWith; 
    PALAVRA wFindWhatLen; 
    PALAVRA wReplaceWithLen; 
    LPARAM lCustData; 
    LPFRHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} FINDREPLACE 

 

Membros

lStructSize

Especifica o comprimento, em bytes, da estrutura.

hwndOwner

Identifica a janela que possui a caixa de diálogo. O procedimento de janela da janela especificada recebe FINDMSGSTRING mensagens da caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, mas não deve ser NULL.

hInstance

Se o sinalizador FR_ENABLETEMPLATEHANDLE é definido na sinalizadores membro, hInstance é o identificador de um objeto de memória que contém um modelo caixa diálogo. Se o sinalizador FR_ENABLETEMPLATE for definido, hInstance identifica um módulo que contém um modelo de caixa de diálogo nomeado pela lpTemplateName membro. Se nenhum sinalizador estiver definido, esse membro será ignorado.

Sinalizadores

Um conjunto de bit sinalizadores que você pode usar para inicializar a caixa de diálogo. A caixa de diálogo define esses sinalizadores quando ele envia o FINDMSGSTRING registrado mensagem para indicar a entrada do usuário. Esse membro pode ser uma combinação dos sinalizadores a seguir:

Bandeira	Significado
FR_DIALOGTERM
	Se definido em uma mensagem FINDMSGSTRING, indica que a caixa de diálogo está fechando. Quando você recebe uma mensagem com esse conjunto sinalizador, o identificador de janela de caixa de diálogo retornado pela função FindText ou ReplaceText já não é válido.
FR_DOWN
	Se definido, o botão para baixo de botões de opção de direção em uma caixa de diálogo Localizar é seleccionado, indicando que você deve pesquisar do local atual para o final do documento. Se não for definido, o botão é selecionado por isso você deve pesquisar para 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
	Permite que a função de gancho especificada na lpfnHook membro. Este sinalizador é usado somente para inicializar a caixa de diálogo.
FR_ENABLETEMPLATE
	Indica que o hInstance e lpTemplateName Membros especificar um modelo de caixa de diálogo para usar no lugar do modelo padrão. Este sinalizador é usado somente para inicializar a caixa de diálogo.
FR_ENABLETEMPLATEHANDLE
	Indica que o hInstance membro identifica um bloco dados que contém um modelo caixa diálogo pré-carregadas. O sistema ignora o lpTemplateName membro se este sinalizador for especificado.
FR_FINDNEXT
	Se definido em uma mensagem FINDMSGSTRING, indica que o usuário clicou no botão Localizar próxima em uma caixa de diálogo Localizar ou Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres para pesquisar.
FR_HIDEUPDOWN
	Se definir ao inicializar a caixa de diálogo Localizar , oculta os botões de opção de direção de pesquisa.
FR_HIDEMATCHCASE
	Se a caixa de seleção do conjunto ao inicializar um Localizar ou Substituir caixa de diálogo, oculta o MatchCase .
FR_HIDEWHOLEWORD
	Se a caixa de seleção do conjunto ao inicializar um Localizar ou Substituir caixa de diálogo, oculta a correspondênciatodapalavrasó .
FR_MATCHCASE
	Se definido, a caixa de seleção Match Case está marcado, indicando que a pesquisa deve ser diferencia maiúscminúsc de minúsculas. Se não for definido, a caixa de seleção está desmarcada assim que a pesquisa deve ser case-insensitive. 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
	Se a caixa de seleção do conjunto ao inicializar um Localizar ou Substituir caixa de diálogo, desactiva o MatchCase .
FR_NOUPDOWN
	Se definir ao inicializar a caixa de diálogo Localizar , desativa os botões de opção de direção de pesquisa.
FR_NOWHOLEWORD
	Se a caixa de seleção do conjunto ao inicializar um Localizar ou Substituir caixa de diálogo, desativa a todapalavra .
FR_REPLACE
	Se definido em uma mensagem FINDMSGSTRING, indica que o usuário clicou o botão Substituir na caixa de diálogo Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres a ser substituído e o membro lpstrReplaceWith especifica a Cadeia de caracteres de substituição.
FR_REPLACEALL
	Se definido em uma mensagem FINDMSGSTRING, indica que o usuário clicou no botão Substituir tudo na caixa de diálogo Substituir . O membro lpstrFindWhat especifica a Cadeia de caracteres a ser substituído e o membro lpstrReplaceWith especifica a Cadeia de caracteres de substituição.
FR_SHOWHELP
	Faz com que a caixa de diálogo Exibir no botão Ajuda . O hwndOwner membro deve especificar a janela para receber a HELPMSGSTRING registadas mensagens de caixa de diálogo envia quando o usuário clica no botão Ajuda.
FR_WHOLEWORD
	Se conjunto, corresponder toda palavra somente caixa de seleção está marcado, indicando que você deve procurar somente palavras inteiras que correspondem à string de pesquisa. Se não for definido, a caixa de seleção está desmarcada para que você também deve procurar fragmentos de palavras que correspondem à string 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

Ponteiro para uma reserva que usa uma mensagem FINDMSGSTRING para passar a Cadeia de caracteres nula finalizada busca que o usuário digitou na encontraro que o Controlarar de editar. Você deve dinamicamente alocar o buffer ou usar uma matriz global ou estática para que ele não vá fora do escopo antes que a caixa de diálogo é fechada. A reserva deve ser pelo menos 80 caracteres de comprimento. Se o buffer contém uma Cadeia de caracteres quando você inicializa a caixa de diálogo, a Cadeia de caracteres é exibida no Controlarar de editar Localizaro que .

Se uma mensagem FINDMSGSTRING especifica o Sinalizar FR_FINDNEXT, lpstrFindWhat contém a Cadeia de caracteres para pesquisar para. Os sinalizadores FR_DOWN, FR_WHOLEWORD e FR_MATCHCASE indicam a direção e o tipo de pesquisa. Se uma mensagem FINDMSGSTRING especifica que sinalizadores FR_REPLACE ou FR_REPLACE, lpstrFindWhat contém a Cadeia de caracteres a ser substituído.

lpstrReplaceWith

Ponteiro para uma reserva que usa uma mensagem FINDMSGSTRING para passar a Cadeia de caracteres nula finalizada substituição que o usuário digitou no Substituircom o Controlarar de editar. Você deve dinamicamente alocar o buffer ou usar uma matriz global ou estática para que ele não vá fora do escopo antes que a caixa de diálogo é fechada. Se o buffer contém uma Cadeia de caracteres quando você inicializa a caixa de diálogo, a Cadeia de caracteres é exibida no Controlarar de editar Substituircom .

Se uma mensagem FINDMSGSTRING especifica os sinalizadores FR_REPLACE ou FR_REPLACEALL, lpstrReplaceWith contém a Cadeia de caracteres de substituição.

A função FindText ignorará esse membro.

wFindWhatLen

Especifica o comprimento, em bytes, do buffer apontado pelo membro lpstrFindWhat.

wReplaceWithLen

Especifica o comprimento, em bytes, do buffer apontado pelo membro lpstrReplaceWith.

lCustData

Especifica dados application-defined que o sistema passa para o procedimento gancho identificado pelo lpfnHook membro. Quando o sistema envia o WM_INITDIALOG mensagem para o procedimento gancho, lParam parâmetro a mensagem é que um ponteiro para a estrutura FINDREPLACE especificado quando o diálogo foi criado. O procedimento de gancho pode usar esse ponteiro para obter o valor de lCustData.

lpfnHook

Ponteiro para um FRHookProc procedimento gancho que pode mensagens processo destinadas a caixa de diálogo. Esse membro é ignorado a menos que o sinalizador FR_ENABLEHOOK é definido na sinalizadores membro.

Se o procedimento gancho retorna FALSE em resposta à mensagem WM_INITDIALOG, o procedimento de gancho deve exibir a caixa de diálogo ou então a caixa de diálogo não será exibida. Para fazer isso, primeiro executar outras operações de pintura e, em seguida, chamar as funções ShowWindow e UpdateWindow.

lpTemplateName

Ponteiro para uma seqüência de caracteres null-terminated que nomeia o recurso de modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para recursos de caixa de diálogo numerada, isso pode ser um valor retornado pela MAKEINTRESOURCE macro. Esse membro é ignorado a menos que o sinalizador FR_ENABLETEMPLATE é definido na sinalizadores membro.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, estruturas de caixa de diálogo comuns, FindText, FRHookProc, MAKEINTRESOURCE, ReplaceText, ShowWindow, UpdateWindow, WM_INITDIALOG

Index