Classe CFindReplaceDialog

Artigo
06/10/2015

Permite que você implemente localize padrão de cadeia de caracteres/substituem caixas de diálogo em seu aplicativo.

class CFindReplaceDialog : public CCommonDialog

Membros

Construtores public

Nome	Descrição
CFindReplaceDialog::CFindReplaceDialog	Chamar essa função para construir um objeto de CFindReplaceDialog .

Métodos públicos

Nome	Descrição
CFindReplaceDialog::Create	Cria e exibe uma caixa de diálogo de CFindReplaceDialog .
CFindReplaceDialog::FindNext	Chamar essa função para determinar se o usuário deseja localizar a próxima ocorrência da cadeia de caracteres de localização.
CFindReplaceDialog::GetFindString	Chamar essa função para recuperar a cadeia de caracteres atual de localização.
CFindReplaceDialog::GetNotifier	Chamar essa função para recuperar a estrutura de FINDREPLACE no manipulador de mensagem registrado.
CFindReplaceDialog::GetReplaceString	Chamar essa função para recuperar a atual substituem a cadeia de caracteres.
CFindReplaceDialog::IsTerminating	Chamar essa função para determinar se a caixa de diálogo é de terminação.
CFindReplaceDialog::MatchCase	Chamar essa função para determinar se o usuário deseja corresponder exatamente aos exemplos de cadeia de caracteres de localização.
CFindReplaceDialog::MatchWholeWord	Chamar essa função para determinar se o usuário deseja corresponder palavras inteiras repetidas somente.
CFindReplaceDialog::ReplaceAll	Chamar essa função para determinar se o usuário deseja todas as ocorrências da cadeia de caracteres a ser substituída.
CFindReplaceDialog::ReplaceCurrent	Chamar essa função para determinar se o usuário deseja a palavra atual para ser substituídas.
CFindReplaceDialog::SearchDown	Chamar essa função para determinar se o usuário deseja a pesquisa para continuar em uma direção descendente.

Membros públicos de dados

Nome	Descrição
CFindReplaceDialog::m_fr	Uma estrutura usada para personalizar um objeto de CFindReplaceDialog .

Comentários

Diferentemente de outras caixas de diálogo comuns do windows, os objetos de CFindReplaceDialog são sem-modo, permitindo que os usuários interagir com outras janelas enquanto estiverem na tela. Há dois tipos de objetos de CFindReplaceDialog : As caixas de diálogo localizar e localize/substituem caixas de diálogo. Embora as caixas de diálogo permitem que o usuário entre a pesquisa e a pesquisa/substitui cadeias de caracteres, não executa algumas das funções de pesquisa ou substituindo. Você deve adicionar esses ao aplicativo.

Para criar um objeto de CFindReplaceDialog , use o construtor fornecido (que não tem nenhum argumento.) Desde que esta é uma caixa de diálogo sem-modo, atribua o objeto no heap usando o operador de new , em vez de na pilha.

Depois que um objeto de CFindReplaceDialog foi construído, você deve chamar a função de membro de Criar para criar e exibir a caixa de diálogo.

Use a estrutura de m_fr para inicializar a caixa de diálogo antes de chamar Criar. A estrutura de m_fr é do tipo FINDREPLACE. Para obter mais informações sobre essa estrutura, consulte Windows SDK.

Para que a janela pai seja notificada de localização/substituir solicitações, você deve usar a função de RegisterWindowMessage do windows e usar a macro de mensagem- mapa de ON_REGISTERED_MESSAGE na sua janela de quadro que trata essa mensagem registrada.

Você pode determinar se o usuário decidir a caixa de diálogo finalizar com a função de membro de IsTerminating .

CFindReplaceDialog depende do arquivo de COMMDLG.DLL que vem com versões 3,1 e posterior do windows.

Para personalizar a caixa de diálogo, derive uma classe de CFindReplaceDialog, forneça um modelo personalizado da caixa de diálogo, e adicionar um mapa de mensagens para processar as notificações dos controles estendidos. Todas as mensagens não processadas devem ser passada para a classe base.

Personalizar a função de gancho não é necessário.

Para obter mais informações sobre como usar CFindReplaceDialog, consulte Classes comuns da caixa de diálogo.