VC程序中定制对话框中的回车键

基于对话框的程序中，每当用户按下回车键时，程序都会退出，其效果和按下对话框中的默认"OK"按钮是一样的，即使去掉"OK"按钮的 BS_DEFPUSHBUTTON 属性也没用。那么如何定制回车键的行为呢？这个问题在Windows的开发中由来已久，对于初学者来说，这是个恼人的问题，幸运的是，人们找到了很多种解决这个问题的方案。本实例将告诉你实现定制回车键行为的方法。

　　 一、实现方法

　　如果想要使回车键无效，最简单的方法是重载OnOK（）函数，这固然是个不坏的主意，但如果重载OnOK（）函数，让它什么事情也不干，那么当用户用鼠标按下"OK"按钮想真正做些什么的时候怎么办呢？你可以改变回车键的ID，如：ID_MY_OK，并写一个调用EndDialog（）的处理器，这个方法虽然也能行得通，但显得有点不专业。

　　另外一种方法是"disable"回车键的"默认"属性。这也是本文开始所提出的方法，之所以没有成功，是因为仅仅不设置"OK"按钮的BS_DEFPUSHBUTTON 属性是不够的，可以利用Visual C++中的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（）响应函数，但它是一个低级趣味的东西，应该想方设法尽量避免使用它，更糟的还有WM_KEYDOWN，WM_KEYUP之类的消息。谁能处理这些消息呢？OnChar（）可以用来限制允许输入编辑框的字符，如：数字，字母等。如果想要将一个键映射到一个命令，加速键才是最好的方法。

　　在本实例中为VK_RETURN创建了一个加速键，将它映射到命令ID_MY_ENTER，并写一个命令处理器来实现任何想实现的事情。

　　如果你细心的话会发现另外一个还没有得到解决的问题，那就是在MFC对话框不自动处理加速键，你必须自己编写代码来做这件事情。为了理解弄清楚这是为什么，让我们回首Windows开发的历程，在使用C和原始的Windows API的年代，每一个Windows程序中都有一个叫做消息泵的中枢循环：

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（），就什么都不用担心了。

　　随着Visual 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类是从哪锘竦眉铀偌砟兀康奔釉乜蚣苁保珻FrameWnd::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（）是一个虚拟函数，不用增加一个消息映射入口。仅仅写这个函数就可以了。

　　二、编程步骤

　　1、 启动Visual C++6.0，生成一个Win32应用程序，将该程序命名为"DlgKeys"；

　　2、 使用CLASSWIZARD为应用程序添加CdlgWithAccelerators和CmyDlg类；

　　3、 在程序的资源中添加添加加速键资源，内容如下：ID_MY_ENTER， VK_RETURNVIRTKEY，VIRTKEY；

　　4、添加代码，编译运行程序。

[NextPage]

三、程序代码

/ #include "stdafx.h" // Generic dialog-that-uses-accelerators. class CDlgWithAccelerators : public CDialog { public: 　CDlgWithAccelerators(UINT nIDTemplate, CWnd* pParentWnd = NULL); 　CDlgWithAccelerators(LPCTSTR lpszTemplateName, CWnd* pParentWnd = NULL); 　~CDlgWithAccelerators(); protected: 　HACCEL m_hAccel; // accelerator table 　// MFC overrides 　virtual BOOL OnInitDialog(); 　virtual BOOL PreTranslateMessage(MSG* pMsg); 　DECLARE_MESSAGE_MAP() }; /// // CDlgWithAccelerators is a general-purpose class that adds accelerators to CDialog. #include "stdafx.h" #include "dlgaccel.h" #ifdef _DEBUG #define new DEBUG_NEW #undef THIS_FILE static char THIS_FILE[] = __FILE__; #endif BEGIN_MESSAGE_MAP(CDlgWithAccelerators,CDialog) END_MESSAGE_MAP() CDlgWithAccelerators::CDlgWithAccelerators(LPCTSTR lpszTemplateName, CWnd* pParentWnd) : CDialog(lpszTemplateName, pParentWnd) {} CDlgWithAccelerators::CDlgWithAccelerators(UINT nIDTemplate, CWnd* pParentWnd) : CDialog(nIDTemplate, pParentWnd) {} CDlgWithAccelerators::~CDlgWithAccelerators() {} /// Pre-translate message: translate keystrokes using acclerator table. BOOL CDlgWithAccelerators::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); } Initialize dialog: load accelerators BOOL CDlgWithAccelerators::OnInitDialog() { 　BOOL bRet = CDialog::OnInitDialog(); 　// Load dialog's accelerators 　m_hAccel = ::LoadAccelerators(AfxGetResourceHandle(), 　m_lpszTemplateName); // use same resource name as dialog 　return bRet; } / #include "stdafx.h" #include "resource.h" #include "dlgaccel.h" #include "TraceWin.h" #ifdef _DEBUG #define new DEBUG_NEW #undef THIS_FILE static char THIS_FILE[] = __FILE__; #endif /MFC app class CMyApp : public CWinApp { public: 　CMyApp(); 　~CMyApp(); 　virtual BOOL InitInstance(); 　DECLARE_MESSAGE_MAP() }; CMyApp theApp; // THE one-and-only app frame window class CMainFrame : public CFrameWnd { protected: 　virtual BOOL PreCreateWindow(CREATESTRUCT& cs); public: 　CMainFrame(); 　~CMainFrame(); }; Typical dialog class CMyDlg : public CDlgWithAccelerators { public: 　CMyDlg(CWnd* pParent = NULL); // standard constructor protected: 　HICON m_hIcon; 　void NextInTabOrder(); 　// MFC overrides 　virtual BOOL OnInitDialog(); 　afx_msg void OnMyEnter(); 　afx_msg LRESULT OnGetDefID(WPARAM wp, LPARAM lp); 　DECLARE_MESSAGE_MAP() }; BEGIN_MESSAGE_MAP(CMyApp, CWinApp) END_MESSAGE_MAP() CMyApp::CMyApp() { 　// nothing to do } CMyApp::~CMyApp() { 　// nothing to do } InitInstance: create dialog as child BOOL CMyApp::InitInstance() { 　// create frame window and load it 　CMainFrame* pFrame = new CMainFrame; 　m_pMainWnd = pFrame; 　pFrame->LoadFrame(IDR_MAINFRAME, WS_OVERLAPPED, NULL, NULL); 　CMyDlg dlg(pFrame); // create dialog and run it 　int nResponse = dlg.DoModal(); 　if (nResponse == IDOK) 　{} 　else if (nResponse == IDCANCEL) 　{} 　return FALSE; // quit } CMainFrame::CMainFrame() { 　// nothing to do } CMainFrame::~CMainFrame() { 　// nothing to do } / Pre-create window: set WS_EX_TOOLWINDOW style to hide dialog from task bar BOOL CMainFrame::PreCreateWindow(CREATESTRUCT& cs) { 　if (CFrameWnd::PreCreateWindow(cs)) { 　　cs.dwExStyle |= WS_EX_TOOLWINDOW; 　　return TRUE; 　} 　return FALSE; } BEGIN_MESSAGE_MAP(CMyDlg, CDlgWithAccelerators) ON_COMMAND(ID_MY_ENTER, OnMyEnter) // The following is NOT needed since I am using accelerators to map // ENTER to ID_MY_ENTER. But if all you want to do is ignore the Enter key, // you can handle DM_GETDEFID as below. // ON_MESSAGE(DM_GETDEFID, OnGetDefID) // not used END_MESSAGE_MAP() CMyDlg::CMyDlg(CWnd* pParent) : CDlgWithAccelerators(IDD_MYDIALOG, pParent) {} Initialize dialog: BOOL CMyDlg::OnInitDialog() { 　CDlgWithAccelerators::OnInitDialog(); 　// Set the icon for this dialog. The framework does this automatically 　// when the application's main window is not a dialog 　m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME); 　ASSERT(m_hIcon); 　SetIcon(m_hIcon, TRUE); // Set big icon 　SetIcon(m_hIcon, FALSE); // Set small icon 　// use same resource name as dialog to load dialog's accelerators 　m_hAccel = ::LoadAccelerators(AfxGetResourceHandle(),m_lpszTemplateName); 　ASSERT(m_hAccel); 　return TRUE; // return TRUE unless you set the focus to a control } This is called to handle ID_MY_ENTER--ie, Enter key. void CMyDlg::OnMyEnter() { 　TRACE(_T("CMyDlg::OnMyEnter/n")); 　NextInTabOrder(); // move to next control } Helper function to move focus to the next control. void CMyDlg::NextInTabOrder() { 　CWnd* pWndNext = GetNextDlgTabItem(GetFocus()); 　if (pWndNext) { 　　pWndNext->SetFocus(); 　} } // // This function is not used, since its message map entry is commented out. // If all you want to do is ignore the Enter key (not map it to a command), // then all you have to do is return zero here. Note that you MUST return // the special code DC_HASDEFID in the high-order word!! LRESULT CMyDlg::OnGetDefID(WPARAM wp, LPARAM lp) { 　TRACE(_T("CMyDlg::OnGetDefID/n")); 　return MAKELONG(0,DC_HASDEFID); }

　　 四、小结

　　综上所述，MFC中为对话框添加加速键功能的方法就是：加载加速键和重载PreTranslateMessage（）函数。也就是说，如果开发人员决定在对话框中使用加速键，不用去操心OnGetDefID（）函数的处理，而是要重点实现加速键对应的WM_COMMAND消息响应处理函数。