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

最新推荐文章于 2022-11-21 15:07:14 发布

cliviajin

最新推荐文章于 2022-11-21 15:07:14 发布

阅读量581

点赞数

文章标签： mfc command windows 任务文档框架

http://www.vckbase.com/vckbase/columnist/hangwire/hangwire.asp

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

作者/赵湘宁
 本文例子代码

        基于对话框的程序中，每次按下回车键时，程序都退出。去掉按钮的 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，必须在高位字中返回DC_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，它是一个通用类。希望大家喜欢它。最后祝大伙编程愉快。