跟我一起玩Win32开发(6):创建右键菜单
快捷菜单,说得容易理解一点,就是右键菜单,当我们在某个区域内单击鼠标右键,会弹出一些菜单项。这种类型的菜单,是随处可见的,我们在桌面上右击一下,也会弹出一个菜单。
右键菜单的好处就是方便,它经常和我们正在操作的某个UI元素联系起来,比如我们正在使用文本框输入文本,我们在文本框中右击,就会看到可能有【复制】【清空】【全选】之类的选项,所以,右键菜单也称为“上下文菜单(Context Menu)”。
一般来说,创建并使用快捷菜单,可以按照以下步骤进行:
1、用资源编辑器创建菜单。
2、当我们在窗口上按下鼠标右键,当系统处理WM_RBUTTONUP时会向我们的应用程序发送一条WM_CONTEXTMENU消息,我们通过响应这条消息来决定是否弹出菜单。
3、计算菜单弹出的位置,一般在我们鼠标指针的右下方,该坐标是基于屏幕的,不是窗口的。
4、调用TrackPopupMenu函数显示快捷菜单。
5、因为这种菜单是不属于某个窗口的,它的内存资源不会在窗口销毁时被回收,因此,在TrackPopupMenu返回后要调用DestroyMenu来销毁菜单的资源,释放内存。
好的,基本思路有了,我们就按照这个思路来试一试,看能不能实现一个右键菜单。
首先,用资源编辑器建立一个菜单,因为我们的弹出菜单一般只显示一系列菜项,是没有菜单的头部,不像菜单栏。因此,我们把菜单做成这样:
快捷菜单只会显示我用画笔圈起来的那部分,而上面的【abc】是不显示的,所以你可以让它空着,也可以随便输入一些内容。
然后为每个菜单项设置ID就行了,资源编辑器有时候会产生一堆没有被使用的ID宏,这些我们可以手动删除,当然也可以不管它,反正不影响程序的编译,因为头文件是不参与编译的。我们编译的时候只是编译.cpp文件。
接下来就是捕捉WM_CONTEXTMENU消息。显示菜单。
- case WM_CONTEXTMENU:
- {
- //加载菜单资源
- HMENU hroot = LoadMenu((HINSTANCE)GetWindowLongPtr(hwnd, GWLP_HINSTANCE), MAKEINTRESOURCE(IDR_CONTEXT));
- if(hroot)
- {
- // 获取第一个弹出菜单
- HMENU hpop = GetSubMenu(hroot,0);
- // 获取鼠标右击是的坐标
- int px = GET_X_LPARAM(lParam);
- int py = GET_Y_LPARAM(lParam);
- //显示快捷菜单
- TrackPopupMenu(hpop,
- TPM_LEFTALIGN | TPM_TOPALIGN | TPM_RIGHTBUTTON,
- px,
- py,
- 0,
- (HWND)wParam,
- NULL);
- // 用完后要销毁菜单资源
- DestroyMenu(hroot);
- }
- }
- break;
首先用LoadMenu来加载资源文件中的菜单,注意,它加载的是整个菜单栏,而我们要的是图中标注的子项。
我们这里只有一个子弹出项,所以,GetSubMenu函数获取子项时,索引应为0。
根据MSDN文档的说明,WM_CONTEXTMENU消息的wParam参数指的是弹出菜单的窗口的句柄,lParam参数的低字位是鼠标指针的水平坐标,高字位指的是垂直坐标。
但我们不用自己去转换,我们通过GET_X_LPARAM和GET_Y_LPARAM两个宏可以把lParam中的值转为坐标值,类型为int,要使用这两个宏,需要包含WindowsX.h头文件。接着调用TrackPopupMenu来显示菜单,最后销毁菜单。
函数的具体参数我不想抄MSDN了,大家可以上MSDN查查。如果你觉得英文文档看得不舒服,你不妨使一下技巧,你可以在百度百科上搜,有中文说明,还有一些VB 6 的网站也有API的中文说明,你可以参考一下。
为了使菜单点击后程序能做出反应,我们还要捕捉WM_COMMAND消息。
- case WM_COMMAND:
- {
- switch(LOWORD(wParam))
- {
- case IDM_WANG:
- MessageBox(hwnd,L"你选择了王维。",L"提示",MB_OK);
- break;
- case IDM_MENG:
- MessageBox(hwnd,L"你选择了孟浩然。",L"提示",MB_OK);
- break;
- case IDM_LI:
- MessageBox(hwnd,L"你选择了李白。",L"提示",MB_OK);
- break;
- }
- }
- return 0;
我们来运行一下,看看能不能起作用。
我们感觉到,程序好像是成功了,目的也似乎达到了,但是,如果你细心研究一下,你会发现一个问题,通常我们窗口的快捷菜单都是在窗口的客户区域右击才出现,即除了标题栏和边框,但我们这个程序,你试试,在标题栏上右击,也会出现快捷菜单,而且把系统菜单也覆盖掉了。
很显然,我们是不能这样做的,很不道德,很不忠不孝不仁不义。所以,我们还要考虑一下,用户鼠标右击的位置是否在我们的客户区域范围内。要判断某个点是否在一个矩形范围内,我们可以用PtInRect函数。
于是,把上面的代码改成这样:
- case WM_CONTEXTMENU:
- {
- RECT rect;
- POINT pt;
- // 获取鼠标右击是的坐标
- pt.x = GET_X_LPARAM(lParam);
- pt.y = GET_Y_LPARAM(lParam);
- //获取客户区域大小
- GetClientRect((HWND)wParam, &rect);
- //判断点是否位于客户区域内
- if(PtInRect(&rect, pt))
- {
- //加载菜单资源
- HMENU hroot = LoadMenu((HINSTANCE)GetWindowLongPtr(hwnd, GWLP_HINSTANCE), MAKEINTRESOURCE(IDR_CONTEXT));
- if(hroot)
- {
- // 获取第一个弹出菜单
- HMENU hpop = GetSubMenu(hroot,0);
- //显示快捷菜单
- TrackPopupMenu(hpop,
- TPM_LEFTALIGN | TPM_TOPALIGN | TPM_RIGHTBUTTON,
- pt.x,
- pt.y,
- 0,
- (HWND)wParam,
- NULL);
- // 用完后要销毁菜单资源
- DestroyMenu(hroot);
- }
- }
- }
- break;
然后再次运行,可是你会发现,靠,问题更严重了,无论我在窗口的哪个地方右击,菜单都不出来了。
代码中是用GetClientRect函数来获取窗口客户区域的矩形位置的,我们明明是在窗口中的可视区域右击了,但为什么会没有看到菜单出来呢?我们在调用PtInRect的地方下一个断点,然后调试运行,我们来比较一下,到底鼠标右击的坐标在不在客户区域的矩形内。
有一点我们要注意的,GetClientRect它计算的标准是相对于窗口的,而WM_CONTEXTMENU取出的坐标是基于屏幕的,两个参照点不同,所以在PtInRect中无法正确地比较。所以,我们需要调用ScreenToClient函数把屏幕坐标转为客户区域坐标。但是在弹出菜单的时候,因为我们要传入基于屏幕的坐标,所以,在显示菜单前要用ClientToScreen来还原坐标为相对于屏幕的点。
即:
ScreenToClient....
..........if PtInRect
...........ClientToScreen
............TrackPopupMenu
- case WM_CONTEXTMENU:
- {
- RECT rect;
- POINT pt;
- // 获取鼠标右击是的坐标
- pt.x = GET_X_LPARAM(lParam);
- pt.y = GET_Y_LPARAM(lParam);
- //获取客户区域大小
- GetClientRect((HWND)wParam, &rect);
- //把屏幕坐标转为客户区坐标
- ScreenToClient((HWND)wParam, &pt);
- //判断点是否位于客户区域内
- if(PtInRect(&rect, pt))
- {
- //加载菜单资源
- HMENU hroot = LoadMenu((HINSTANCE)GetWindowLongPtr(hwnd, GWLP_HINSTANCE), MAKEINTRESOURCE(IDR_CONTEXT));
- if(hroot)
- {
- // 获取第一个弹出菜单
- HMENU hpop = GetSubMenu(hroot,0);
- // 把客户区坐标还原为屏幕坐标
- ClientToScreen((HWND)wParam, &pt);
- //显示快捷菜单
- TrackPopupMenu(hpop,
- TPM_LEFTALIGN | TPM_TOPALIGN | TPM_RIGHTBUTTON,
- pt.x,
- pt.y,
- 0,
- (HWND)wParam,
- NULL);
- // 用完后要销毁菜单资源
- DestroyMenu(hroot);
- }
- }
- }
这样一来,就把坐标问题解决了,现在可以弹出菜单了。但还有一个问题没有解决,你会发现,现在在窗口的标题栏上右击,快捷菜单不会再出现了,但是,同时,系统菜单也没有出现。因为系统菜单是由系统来处理的,所以,解决这问题很简单,只要我们把WM_CONTEXT消息发回给系统来处理就行了。
方法一:我们判断了如果右击点在窗口的客户区域时显示菜单,那么,如果不在这个区域内,就把消息再传回给系统处理。
- else
- {
- return DefWindowProc(hwnd, msg, wParam, lParam);
- }
方法二:在WindowsProc函数的最后,统一把所有消息都返回给操作系统处理。
- default:
- // 如果不处理消息,交回系统处理
- return DefWindowProc(hwnd, msg, wParam, lParam);
- }
- return DefWindowProc(hwnd, msg, wParam, lParam);
反正目的只有一个,把WM_CONTEXTMENU消息路由回给系统处理就行了。现在再运行一下,系统菜单可以显示。从这一点我们可以学到一个技巧,如果你想屏蔽窗口的系统菜单,你应该知道怎么做了,就是不让系统有机会响应WM_CONTEXTMENU消息就行了。另外,按Shift + F10快捷键也会收到WM_CONTEXTMENU消息。
完整的代码清单如下:
- #include <Windows.h>
- #include "resource.h"
- #include <WindowsX.h>
- LRESULT CALLBACK MyMainWindowProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam);
- int WINAPI WinMain(
- HINSTANCE hThisApp,
- HINSTANCE hPrevApp,
- LPSTR cmdLine,
- int nShow)
- {
- WNDCLASS wc = { };
- wc.hbrBackground = (HBRUSH)COLOR_WINDOW;
- wc.lpszClassName = L"MyApp";
- wc.style = CS_HREDRAW | CS_VREDRAW;
- wc.hInstance = hThisApp;
- wc.lpfnWndProc = (WNDPROC)MyMainWindowProc;
- //注册窗口类
- RegisterClass(&wc);
- //创建窗口
- HWND hwnd = CreateWindow(
- L"MyApp",
- L"我的超级应用",
- WS_OVERLAPPEDWINDOW,
- 60,
- 25,
- 420,
- 300,
- NULL,
- NULL,
- hThisApp,
- NULL);
- if(hwnd == NULL)
- return 0;
- // 显示窗口
- ShowWindow(hwnd, nShow);
- //消息循环
- MSG msg;
- while(GetMessage(&msg, NULL, 0, 0))
- {
- TranslateMessage(&msg);
- DispatchMessage(&msg);
- }
- return 0;
- }
- LRESULT CALLBACK MyMainWindowProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
- {
- switch(msg)
- {
- case WM_DESTROY:
- PostQuitMessage(0);
- return 0;
- case WM_COMMAND:
- {
- switch(LOWORD(wParam))
- {
- case IDM_WANG:
- MessageBox(hwnd,L"你选择了王维。",L"提示",MB_OK);
- break;
- case IDM_MENG:
- MessageBox(hwnd,L"你选择了孟浩然。",L"提示",MB_OK);
- break;
- case IDM_LI:
- MessageBox(hwnd,L"你选择了李白。",L"提示",MB_OK);
- break;
- }
- }
- return 0;
- case WM_CONTEXTMENU:
- {
- RECT rect;
- POINT pt;
- // 获取鼠标右击是的坐标
- pt.x = GET_X_LPARAM(lParam);
- pt.y = GET_Y_LPARAM(lParam);
- //获取客户区域大小
- GetClientRect((HWND)wParam, &rect);
- //把屏幕坐标转为客户区坐标
- ScreenToClient((HWND)wParam, &pt);
- //判断点是否位于客户区域内
- if(PtInRect(&rect, pt))
- {
- //加载菜单资源
- HMENU hroot = LoadMenu((HINSTANCE)GetWindowLongPtr(hwnd, GWLP_HINSTANCE), MAKEINTRESOURCE(IDR_CONTEXT));
- if(hroot)
- {
- // 获取第一个弹出菜单
- HMENU hpop = GetSubMenu(hroot,0);
- // 把客户区坐标还原为屏幕坐标
- ClientToScreen((HWND)wParam, &pt);
- //显示快捷菜单
- TrackPopupMenu(hpop,
- TPM_LEFTALIGN | TPM_TOPALIGN | TPM_RIGHTBUTTON,
- pt.x,
- pt.y,
- 0,
- (HWND)wParam,
- NULL);
- // 用完后要销毁菜单资源
- DestroyMenu(hroot);
- }
- }
- else
- {
- return DefWindowProc(hwnd, msg, wParam, lParam);
- }
- }
- break;
- default:
- // 如果不处理消息,交回系统处理
- return DefWindowProc(hwnd, msg, wParam, lParam);
- }
- }