查找/替换对话框CFindReplaceDialog的使用

在Windows通用对话框中,查找/替换对话框是比较特殊的一个,它是一个非模态对话框,所以它的使用与其它通用对话框有所不同。

一、注册

注册的目的有两个,一是说明在程序中要使用查找/替换对话框,二是让窗口能响应查找/替换消息,提供相应的消息函数。

注册位置应该在查找/替换对话框的父窗口,比如主框架窗口CMainFrame、视图CxxView或某对话框。也就是响应查找/替换操作的那个窗口。

比如,欲在视图中响应查找/替换操作,则在视图中加入下面的注册代码(红字为添加的代码):

class CEditTestView : public CFormView
{
    …………
protected:
    //{{AFX_MSG(CEditTestView)
    …………
    afx_msg LONG OnFindReplace(WPARAM wParam,LPARAM lParam);
    DECLARE_MESSAGE_MAP()
};

IMPLEMENT_DYNCREATE(CEditTestView, CFormView)
static UINT WM_FINDREPLACE = ::RegisterWindowMessage( FINDMSGSTRING );
BEGIN_MESSAGE_MAP(CEditTestView, CFormView)
    //{{AFX_MSG_MAP(CEditTestView)
    …………
    //}}AFX_MSG_MAP
    ON_REGISTERED_MESSAGE(WM_FINDREPLACE,OnFindReplace)
END_MESSAGE_MAP()

注册完成后,OnFindReplace()函数可用来接收查找/替换对话框的用户消息,另外用ClassWizard打开CEditTestView,可以发现ID_EDIT_FIND和ID_EDIT_REPLACE两个ID号,可以用来添加查找/替换菜单,这在注册前是没有的。

二、对话框的创建与显示

作为非模态对话框,必须用new操作符分配存储空间,再用Create()函数进行初始化,最后用ShowWindow()函数显示对话框。

下面的例子是创建一个查找对话框:先在菜单中用ID号ID_EDIT_FIND添加一个“查找”菜单项,再用ClassWizard添加它的响应函数OnEditFind(),加入代码。

//查找菜单响应函数
void CEditTestView::OnEditFind()
{
    CFindReplaceDialog* pDlg = new CFindReplaceDialog();
    pDlg->Create( true, NULL, NULL, FR_DOWN, this );  //创建查找对话框
    pDlg->ShowWindow( SW_SHOW );    //显示对话框
}

Create()函数的原型如下:

BOOL Create(BOOL bFindDialogOnly,LPCTSTR lpszFindWhat,LPCTSTR lpszReplaceWhat=NULL,DWORD dwFlag=FR_DOWN,CWnd* pParentWnd=NULL);

参数:
bFindDialogOnly为对话框类型,为TRUE时,显示查找对话框,为FALSE时,显示查找/替换对话框;
lpszFindWhat为在查找框中显示的字符串;
lpszReplaceWhat为在替换框中显示的字符串;
dwFlag为标志位,用来定制对话框,它可以是一个或多个标志的组合,主要取值如下:
FR_DOWN 如果设置,对话框中的“向下查找”单选按钮被选中,如果没有设置,“向上查找”单选按钮被选中;
FR_HIDEUPDOWN 不显示查找方向单选按钮;
FR_HIDEMATCHCASE 不显示区分大小写复选按钮;
FR_HIDEWHOLEWORD 不显示全字匹配复选按钮;
FR_MATCHCASE 使区分大小写复选按钮处于选中状态;
FR_WHOLEWORD 使全字匹配复选按钮处于选中状态;
FR_NOMATCHCASE 使区分大小写复选按钮处于禁止(变灰)状态;
FR_NOUPDOWN 使查找方向单选按钮处于禁止(变灰)状态;
FR_NOWHOLEWORD 使全字匹配复选按钮处于禁止(变灰)状态;
FR_SHOWHELP 在对话框中显示一个帮助按钮。
pParentWnd指向对话框的父窗口,如果为NULL,则为主框架窗口,使用时需让它指向接收查找/替换消息的窗口。

上例中定制的是一个查找窗口,它显示为:

如果定制一个查找/替换窗口,可以添加OnEditReplace()函数:

//替换菜单响应函数
void CEditTestView::OnEditReplace()
{
    CFindReplaceDialog* pDlg = new CFindReplaceDialog();
    pDlg->Create( false, m_FindString, m_ReplaceString, FR_DOWN, this );//创建替换对话框
    pDlg->ShowWindow( SW_SHOW );    //显示对话框
}

m_FindString和m_ReplaceString是预定义的字符串变量,用于初始化查找框和替换框。这时它显示为:

在Create()创建对话框前,也可以用成员变量m_fr对对话框进行更详细的定制。

三、响应查找/替换消息

查找/替换对话框显示后,其后单击其上任何一个按钮,消息都被送到窗口回调函数OnFindReplace()函数中,所以我们不需要为每个按钮添加消息函数,所有对按钮消息的处理都在OnFindReplace()函数中进行即可。

这里要注意一点,查找/替换对话框本身没有查找/替换功能,它只是为我们提供了一个接收用户要求的接口,使我们知道用户提出了何种查找/替换要求,真正的查找/替换工作需另行编程实现。这一点与文件对话框相似,用打开文件对话框不能真的打开文件,它只是让我们知道用户想要打开哪个文件而已。

在OnFindReplace()函数中,我们可以用CFindReplaceDialog类的成员函数获知用户请求,其中主要的有:

static CFindReplaceDialog* PASCAL GetNotifier(LPARAM lParam);
获取当前查找/替换对话框的指针。参数lParam为传递给回调函数OnFindReplace()的lParam值。

BOOL FindNext()const;
检取用户是否单击“查找下一个”按钮。

BOOL ReplaceCurrent()const;
检取用户是否单击“替换”按钮。

BOOL ReplaceAll()const;
检取用户是否单击“全部替换”按钮。

利用以上几个函数可以获知用户单击了哪个按钮。但在查找/替换时,还需要知道用户的查找/替换设置,这可以用下面的函数检取这些设置:

CString GetFindString()const;
检取查找的字符串。它可能与设置的初始值不同。

CString GetReplaceString()const;
检取替换的字符串。

BOOL SearchDown()const;
检取查找方向,为TRUE时表示“向下查找”。

BOOL MatchCase()const;
检取“区分大小写”状态,为TRUE时表示要求区分大小写。

BOOL MatchWholeWord()const;
检取“全字匹配”状态,为TRUE时表示要求全字匹配。

以下就是注册的OnFindReplace()函数,其中“……”为需要用户编写的查找/替换操作。

LONG CEditTestView::OnFindReplace(WPARAM wParam,LPARAM lParam)
{
    CFindReplaceDialog* pDlg = CFindReplaceDialog::GetNotifier(lParam);
    m_FindString = pDlg->GetFindString();        //查找串
    m_ReplaceString = pDlg->GetReplaceString();  //替换串
    if( pDlg->FindNext() )          //查找下一个
    {
        …………;
    }
    if( pDlg->ReplaceCurrent() )    //替换
    {
        …………;
    }
    if( pDlg->ReplaceAll() )        //全部替换
    {
        …………;
    }

    return 0;
}

示例程序是一个简易文本编辑器,模仿记事本的查找/替换形式设计了相应的查找/替换形式。

本示例程序与文章《扩展Edit Box控件的功能》的相同。

 

示例程序界面图:

下载示例程序
http://221.199.150.103/jsj/Html/vc/wen/vcwen12.htm

你可能感兴趣的:(查找/替换对话框CFindReplaceDialog的使用)