跟我一起玩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);
	}
}