CFindReplaceDialog::Create

Artigo
02/25/2013

Cria e exibe ou achado ou localize/substitui o objeto da caixa de diálogo, dependendo do valor de bFindDialogOnly.

virtual BOOL Create(
   BOOL bFindDialogOnly,
   LPCTSTR lpszFindWhat,
   LPCTSTR lpszReplaceWith = NULL,
   DWORD dwFlags = FR_DOWN,
   CWnd* pParentWnd = NULL 
);

Parâmetros

bFindDialogOnly
Defina o parâmetro como TRUE para exibir uma caixa de diálogo de Localizar .Defina a FALSE para exibir uma caixa de diálogo de Localizar/substitua .
lpszFindWhat
Ponteiro para a cadeia de caracteres de pesquisa padrão quando a caixa de diálogo aparecer.Se NULL, a caixa de diálogo não contém uma cadeia de caracteres de pesquisa padrão.
lpszReplaceWith
Ponteiro para a cadeia de caracteres padrão de substituição quando a caixa de diálogo aparecer.Se NULL, a caixa de diálogo não contém uma cadeia de caracteres padrão de substituição.
dwFlags
Um ou vários sinalizadores que você pode usar para personalizar as configurações da caixa de diálogo, combinadas usando o operador OR bit a bit.O valor padrão é FR_DOWN, que especifica que a pesquisa é continuar em uma direção descendente.Consulte a estrutura de FINDREPLACE em Windows SDK para obter mais informações sobre esses sinalizadores.
pParentWnd
Um ponteiro para a janela pai ou do proprietário da caixa de diálogo.Esta é a janela que receberá uma mensagem especial que indica que um localizar/substitui a ação é solicitado.Se NULL, a janela principal do aplicativo é usado.

Valor de retorno

Diferente de zero se o objeto da caixa de diálogo foi criado com êxito; se não 0.

Comentários

Para que a janela pai seja notificada de localização/substituir solicitações, você deve usar a função de RegisterWindowMessage do windows cujo valor de retorno é um número de mensagem exclusivo à instância do aplicativo.A janela do quadro deve ter uma entrada de mapa de mensagem que declara a função de retorno de chamada (OnFindReplace no exemplo que segue) que manipula esta mensagem registrada.O fragmento de código a seguir é um exemplo de como fazer isso para uma janela CMyRichEditViewchamado classe frame:

// Message handler declared in CMyRichEditView class declaration
protected:
   afx_msg LONG OnFindReplace(WPARAM wParam, LPARAM lParam);

// Register FindReplace window message.
static UINT WM_FINDREPLACE = ::RegisterWindowMessage(FINDMSGSTRING);

// Message map entry to map from message to handler function.
ON_REGISTERED_MESSAGE(WM_FINDREPLACE, &CMyRichEditView::OnFindReplace)

Em sua função de OnFindReplace , você interpreta as intenções do usuário usando CFindReplaceDialog::FindNext e métodos e de CFindReplaceDialog::IsTerminating você cria o código para localizar o/substituem operações.