如何定制对话框中的回车键

如何定制对话框中的回车键

作者/赵湘宁


本文例子代码

    基于对话框的程序中,每次按下回车键时,程序都退出。去掉按钮的 BS_DEFPUSHBUTTON 属性并重写OnOK函数也没用。那么如何定制回车键的行为呢?这个问题很easy,但是要说明白,却要费点时间。 
    这个问题在Windows的开发中由来已久,对于初学者来说,这是个恼人的问题,幸运的是,人们找到了多种解决这个问题的方案。本文将告诉你定制回车键行为的方法。 
    如果你想要disable回车键,最简单的方法是重载OnOK函数,这固然是个不坏的主意,但如果你重载OnOK,让它什么事情也不干,那麽当用户用鼠标按下回车键想真正做些什么的时候怎么办呢?你可以改变回车键的ID,如:ID_MY_OK,并写一个调用EndDialog的处理器,这个方法虽然也能行得通,但显得有点不专业。 
    另外一种方法是disable回车键的“默认”属性。这也是本文开始所提出的方法,之所以没有成功,是因为仅仅uncheck 回车键的 BS_DEFPUSHBUTTON 属性是不够的,你可以利用Spy++仔细地观察控制和实验就能发现回车键仍然我行我素发送退出消息。
    问题出在哪呢?你必须区分OK键和回车键,你可以写一个OnOK处理器调用GetCurrentMessage函数获取最后发送的消息,应该是WM_COMMAND,再检查WPARAM的低位字(low-order word)看看命令来自何处。 
    要解决问题,必须搞清楚背后所发生的一切,在Spy++中可以看到,当用户按下回车键时,Windows发送一个特殊的WM_GETDEFID消息来获得缺省的命令ID,Windows再将它作为WM_COMMAND发送。所以,你要做的就是重载WM_GETDEFID消息,在有关Windows的文档中是这样描述WM_GETDEFID返回值的:“如果有缺省得按钮,则返回值的高位字包含DC_HASDEFID,低位字包含控制的标识符。否则,返回值是零。”
根据这段描述,假设如果没有缺省得按钮,则返回值应该是零。如果想要disable缺省得ID,必须在高位种蟹祷谼C_HASDEFID。

BEGIN_MESSAGE_MAP(CMyDlg, CDialog)
    ON_MESSAGE(DM_GETDEFID, OnGetDefID)
    ...
END_MESSAGE_MAP()

LRESULT CMyDlg::OnGetDefID(WPARAM wp, LPARAM lp) 
{
    return MAKELONG(0,DC_HASDEFID); 
} 

    因为MFC没有对应DM_GETDEFID的宏,你必须使用通用的ON_MASSAGE宏。这样用户可以随意按回车键,但什么事都不会发生。上面的做法是解决了按回车键程序退出的问题。但是又产生了另外一个问题:如果想要回车键做些事情怎么办呢?有一些人曾经问过如何将回车键映射到TAB键,既按下回车键就象按下TAB键一样-也就是说输入焦点移动到下一个对话框控制。这需要做一些工作才行,但最简单的方式是使用加速键。许多程序员试图用OnChar,我会对他们说:No,no,no! OnChar是一个低级趣味的东西,你应该想方设法避免它,更糟的还有WM_KEYDOWN,WM_KEYUP之类的东西。谁能处理这些东西?OnChar可以用来限制允许输入编辑框的字符,如:数字,字母等。如果想要将一个键映射到一个命令,加速键才是最好的方法。
    在本文的例子为VK_RETURN创建了一个加速键,将它映射到命令ID_MY_ENTER,并写一个命令处理器来做你想做的事情。

BEGIN_MESSAGE_MAP(CMyDlg, CDialog) 
    ON_COMMAND(ID_MY_ENTER, OnMyEnter)
    ......
END_MESSAGE_MAP() 

void CMyDlg::OnMyEnter() 
{
    NextInTabOrder(); 
} 

  下图是本文例子的对话框和代码,代码中的NextInTabOrder是实际起作用的函数。它使用GetNextDlgTabItem来获得Tab顺序的下一个控制焦点。


while (GetMessage(...)) { 
    TranslateMessage(...);
    DispatchMessage(...); 
} 

    在这里细节不是重要的,重要的是消息并不到达程序的流程,你必须请求消息。这是一种人为的非抢先式多任务方法,这种方法通过每一个任务精诚协作来仿造多任务环境,随着增加的功能越来越多,有人想到了加速键表的主意,这个表用来映射按键和命令IDs。为了实现这个目的,他们发明了一个叫TranslateAccelerator的函数。现在这个消息泵变成了如下的样子:

while (GetMessage(...)) { 
    if (TranslateAccelerator(hAccel...)) { 
        // handled, continue looping     
    } else { 
        TranslateMessage(...); 
        DispatchMessage(...); 
    } 
} 

    hAccel是个加速键表句柄,在这里细节同样不是重要的,重要的是如何利用加速键表,也就是要有一个专门的函数将按键消息解释为WM_COMMAND消息。TranslateAccelerator寻找WM_KEYDOWN,WM_CHAR,WM_KEYUP序列与表中键值匹配的字符。如果找到,它插入一条WM_COMMAND到消息队列,在消息队列中的命令ID可以是加速键表定义的任何入口。这样你只要设置加速键表(在资源中)并记住调用对应的函数TranslateAccelerator,就什么都不用担心了。
    时间转眼间进入了21世纪,随着C++和MFC的日臻成熟,现在几乎整个消息循环(但不是全部)都被隐藏到了MFC中,为了能让任何窗口都有机会获得一点消息泵的行为,MFC提供了一个专门的虚函数PreTranslateMessage,如果你有足够的勇气去探究CWinThread中的消息处理机制的话,你会遇到类似如下的代码:

// 简化后的 CWinThread 
while (GetMessage(...)) { 
    if (PreTranslateMessage(...)) { 
        // continue looping 
    } else { 
        TranslateMessage(...); 
        DispatchMessage(...); 
    }
} 

    CWinThread::PreTranslateMessage是个虚函数,在应用中,其缺省的实现以相同的名字调用另一个虚函数,CWnd::PreTranslateMessage。因此,如果你需要在消息循环中做些什么的话-如解释加速键-你只要重载PreTranslateMessage即可。实际上,这就是CFrameWnd处理加速键的方法。

BOOL CFrameWnd::PreTranslateMessage(MSG* pMsg) 
{ 
    ......
    if (pMsg->message >= WM_KEYFIRST && 
        pMsg->message <= WM_KEYLAST) 
    { 
        ::TranslateAccelerator(m_hAccelTable,...); 
    } 
}  

    CFrameWnd 从哪里获得加速键表呢?当你加载框架时,CFrameWnd::LoadFrame用与文档模板相同的ID(如IDR_MAINFRAME)查找加速键表,并将他加载到m_hAccelTable。所有的处理细节在MFC中都是自动的、隐蔽的,你不用去操心-仅对主框架而言,如果是对话框,则是另外一种情况。因为CDialog不是从CFrameWnd派生而来,所以不继承任何有关加速键的内容。
    不用担心,我们可以模仿CFrameWnd的工作,很容易为对话框增加加速键的功能。第一步是加载加速键,加载加速键最好的地方是在对话框的OnInitDialog函数中:

BOOL CMyDlg::OnInitDialog() 
{ 
    CDialog::OnInitDialog(); 
    ......
    // Load accelerators 
    m_hAccel = ::LoadAccelerators(AfxGetResourceHandle(), 
        m_lpszTemplateName); 
    ASSERT(m_hAccel); 

    return TRUE; 
}

    在加速键表中,你可以使用任何ID。这里我使用的是对话框本身的ID,(m_lpszTemplateName既可以是一个串名,也可以是一个MAKEINTRESOURCE使用的整型ID):

// 本文例子中的加速键(In DlgKeys.rc )
IDD_MYDIALOG ACCELERATORS DISCARDABLE  
BEGIN 
    VK_RETURN, ID_MY_ENTER, VIRTKEY, NOINVERT 
END 

一旦你已经加载加速键,剩下的事情是重载PreTranslateMessage函数:

BOOL CMyDlg::PreTranslateMessage(MSG* pMsg) 
{ 
    if (WM_KEYFIRST <= pMsg->message && 
        pMsg->message <= WM_KEYLAST) 
    { 
        HACCEL hAccel = m_hAccel; 
        if (hAccel && 
            ::TranslateAccelerator(m_hWnd, hAccel, pMsg)) 
            return TRUE; 
    } 
    return CDialog::PreTranslateMessage(pMsg); 
}

    之所以要检查按键类的消息(从WM_ KEYFIRST 到 WM_KEYLAST)是为了提高速度。如果你知道不是一个按键消息,你就不用浪费时间去调用TranslateAccelerator。再说TranslateAccelerator是一个虚拟函数,不用增加一个消息映射入口。仅仅写这个函数就可以了。
    综上所述,MFC中为对话框添加加速键功能的方法就是:加载加速键和重载PreTranslateMessage函数。也就是说,如果你决定使用加速键,不用去操心OnGetDefID,而是将没有命令处理器的ID映射到VK_RETURN。本文的例子代码中封装了一个又加速键的新对话框类:CdlgWinAccelerators,它是一个通用类。希望大家喜欢它。最后祝大伙编程愉快。

阅读更多
想对作者说点什么?

博主推荐

换一批

没有更多推荐了,返回首页