《Windows API每日一练》6.2 客户区鼠标消息
第五章已经讲到，Windows只会把键盘消息发送到当前具有输入焦点的窗口。鼠标消息则不同：当鼠标经过窗口或在窗口内被单击，则即使该窗口是非活动窗口或不带输入焦点， 窗口过程还是会收到鼠标消息。Windows定义了 21种鼠标消息。不过，其中11种消息与 客户区无关，称为“非客户区消息”。Windows应用程序经常忽略这类消息。
本节必须掌握的知识点：
客户区鼠标消息
第35练：客户区鼠标消息的处理
6.2.1 客户区鼠标消息
■客户区鼠标消息
当鼠标移经窗口客户区时，窗口过程接收WM_MOUSEMOVE消息。在窗口客户区内按下或释放鼠标按钮时，窗口过程接收如下表所示的消息：
| 按钮 | 按下 | 释放 | 第二次按下按钮 |
| 左键 | WM_LBUTTONDOWN | WM_LBUTTONUP | WM_LBUTTONDBLCLK |
| 中键 | WM_MBUTTONDOWN | WM_MBUTTONUP | WM_MBUTTONDBLCLK |
| 右键 | WM_RBUTTONDOWN | WM_RBUTTONUP | WM_RBUTTONDBLCLK |
窗口过程只对三键鼠标接收MBUTTON消息，只对双键鼠标接收RBUTTON消息。而只有当窗口类被定义成接收鼠标双击时，窗口过程才接收DBLCLK（双击）消息。
对所有这些消息来说，参数IParam包含了鼠标的位置信息，其中低位字表示x坐标， 高位字表示y坐标，它们都是相对于窗口客户区左上角的相对坐标。利用LOWORD宏和 HIWORD宏，可以获取这些坐标值：
X = LOWORD (IParam);
y = HIWORD (IParam);
参数wParam表示鼠标按钮、Shift键和Ctrl键的状态。可以利用WINUSER.H头文件中定义的位掩码来测试参数wParam。前缀MK代表“鼠标键”（mouse key)。
MK_LBUTTON 按下左键
MK_MBUTTON 按下中键
MK_RBUTTON 按下右键
MK_SHIFT 按下 Shift 键
MK_CONTROL 按下 Ctrl 键
例如，当接收到WM_LBUTTONDOWN消息时，若wparam & MK_SHIFT 的值为TRUE（非零），则表示按下鼠标左键的同时按下了 Shift键。
●处理Shift键
| 处理过程依赖Shift和Ctrl键的逻辑处理 | 单键鼠标模拟双键鼠标 |
| if (wParam & MK_SHIFT) //按下Shift { if (wParam & MK_CONTROL) { [按下Shift + Ctrl键]; } else{ [只按下Shift键]; } }else{ //未按Shift if (wParam & MK_CONTROL) { [只按下Ctrl键]; }else{ [Shift和Ctrl都没被按下]; } } | case WM_LBUTTONDOWN: //未按Shift时，直接处理左键 if (!(wParam & MK_SHIFT)) { [这里处理左键]; return 0; } //注意，这里没有return。 //用户按下了鼠标左键+Shift，执行以下代码，模拟右键。 case WM_RBUTTONDOWN: [这里处理右键]; return 0; 【注意】双键鼠标也是可以正常处理的。单键鼠标可以通过按住鼠标左键+Shift，来模拟鼠标右键的功能。 |
【注意】GetKeyState可以通过VK_LBUTTON、VK_RBUTTON、VK_SHIFT、VK_CONTROL等获取鼠标当前状态。但鼠标或键盘未被按下的键不能使用GetKeyState。只有被按下时才会报告其按下状态。（while(GetKeyState(VK_LBUTTON)>=0)）是错误的代码。
●鼠标移经窗口的客户区时，Windows系统不会为鼠标经过的每个像素位置都产生 WM_MOUSEMOVE消息。程序收到的WM_MOUSEMOVE消息个数取决于鼠标硬件和窗口过程处理鼠标移动消息的速度。换言之，如果消息队列里还有未处理的 WM_MOUSEMOVE消息，Windows就不会重复向消息队列中添加该消息。试验下面这个 CONNECT程序，可以对WM_MOUSEMOVE消息的产生速度有一个全面的了解。
●若在非活动窗口的客户区内按下鼠标左键，Windows会将该窗口变为活动窗口，并向窗口过程发送WM_LBUTTONDOWN消息。当窗口过程接收到WM_LBUTTONDOWN消息时，程序就能够安全地保证该窗口是活动窗口。但是，在事先没有接收 WM_LBUTTONDOWN消息的情况下，窗口过程仍然可以接收WM_LBUTTONUP消息。 比如，当用户在其他窗口内按下鼠标，再移动到用户窗口，然后释此时就会发生这种情况。类似地，当移动鼠标到另一个窗口再释放时，前一个窗口过程在接收 WM_LBUTTONDOWN消息后，就接收不到相应的WM_LBUTTONUP消息。
■前面这些规则有两个例外：
●即使鼠标位于窗口的客户区之外，窗口过程也有办法“捕获鼠标”，并且继续接收鼠标消息。本章会在后面讲述如何捕获鼠标。
●若正在显示一个系统模式消息框或系统模式对话框，则其他任何程序都不能接收鼠标消息。当系统模式消息框或对话框处于活动状态时，它们会阻止系统切换到另一个窗口。例如，关闭Windows时弹出的消息框就是一个系统模式消息框。
6.2.2 第35练：客户区鼠标消息的处理
/*---------------------------------------------------------------
035 WIN32 API 每日一练
第35个例子CONNECT.C：客户区鼠标消息的处理
SetPixel函数
SetCursor函数
ShowCursor函数
WM_LBUTTONDOWNE消息
WM_MOUSEMOVE消息
WM_LBUTTONUP消息
(c) www.bcdaren.com, 2020
----------------------------------------------------------------*/
#include <windows.h>
#define MAXPOINTS 1000
LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ;
int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,
PSTR szCmdLine, int iCmdShow)
{
static TCHAR szAppName[] = TEXT("Connect");
…(略)
return msg.wParam;
}
LRESULT CALLBACK WndProc ( HWND hwnd, UINT message, WPARAM wParam,LPARAM
lParam)
{
static POINT pt[MAXPOINTS];//鼠标经过窗口区像素点坐标数组
static int iCount;
HDC hdc;
int i,j;
PAINTSTRUCT ps;
switch (message)
{
/*测试：非客户区消息
//用于通知应用程序在非客户区（Non-Client Area）
//接收到鼠标消息时进行的命中测试（Hit Test）。
case WM_NCHITTEST:
//直接返回位置信息，阻止系统向所有窗口客户区和非窗口客户区发送鼠标消息
return (LRESULT)HTNOWHERE;
//测试：按下ALT+F、Ctrl+C等系统消息
case WM_SYSKEYDOWN:
//直接返回，使所有系统键盘消息失效
return 0;*/
//按下鼠标左键消息
case WM_LBUTTONDOWN:
iCount = 0;
InvalidateRect(hwnd,NULL,TRUE);//重绘窗口---清除背景
return 0;
//鼠标移动消息
case WM_MOUSEMOVE:
//按下鼠标左键并且iCount小于1000
if (wParam & MK_LBUTTON && iCount < 1000)
{
//填充坐标数组
pt[iCount].x = LOWORD(lParam);
pt[iCount++].y = HIWORD(lParam);
hdc = GetDC(hwnd);
//设置像素点颜色，RGB(0)黑色
SetPixel(hdc,LOWORD(lParam),HIWORD(lParam),0);
ReleaseDC(hwnd,hdc);
}
return 0;
//松开鼠标左键消息
case WM_LBUTTONUP:
//重新绘制窗口---不清除背景，保留WM_MOUSEMOVE里画下的点。
InvalidateRect(hwnd,NULL,FALSE);
return 0;
case WM_PAINT:
hdc = BeginPaint(hwnd,&ps);
SetCursor(LoadCursor(NULL,IDC_WAIT));//设置鼠标形状为等待状态
ShowCursor(TRUE);//显示鼠标
//像素点之间画线
for (i = 0;i < iCount - 1;i++)
{
for (j = 0;j < iCount - 1;j++)
{
MoveToEx(hdc,pt[i].x,pt[i].y,NULL);
LineTo(hdc,pt[j].x,pt[j].y);
}
}
ShowCursor(FALSE);//隐藏鼠标
SetCursor(LoadCursor(NULL,IDC_ARROW));//设置鼠标位图“箭头形状”
EndPaint(hwnd,&ps);
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, message, wParam, lParam);
}
/***************************************************************************
SetPixel函数：指定坐标到指定的颜色设置像素
COLORREF SetPixel(
HDC hdc,
int x, //坐标
int y,
COLORREF color //RGB颜色
);
***************************************************************************
SetCursor函数：设置鼠标形状
HCURSOR SetCursor(
HCURSOR hCursor //IDC_ARROW，IDC_WAIT
);
ShowCursor函数：显示/隐藏鼠标
int ShowCursor(
BOOL bShow //TRUE显示，FALSE隐藏
);
***************************************************************************
WM_LBUTTONDOWNE消息:当光标在窗口的客户区域中时用户按下鼠标左键时发布。
如果未捕获鼠标，则消息将发布到光标下方的窗口。否则，该消息将发布到捕获鼠标的窗口中。
参数wParam：指示各种虚拟键是否按下。此参数可以是以下一个或多个值。
MK_CONTROL 0x0008 CTRL键按下。
MK_LBUTTON 0x0001 鼠标左键按下。
MK_MBUTTON 0x0010 鼠标中键按下。
MK_RBUTTON 0x0002 鼠标右键按下。
MK_SHIFT 0x0004 SHIFT键按下。
MK_XBUTTON1 0x0020 第一个X按钮按下。
MK_XBUTTON2 0x0040 第二个X按钮按下。
lParam：
低位字指定光标的x坐标。坐标相对于客户区域的左上角。
高阶字指定光标的y坐标。坐标相对于客户区域的左上角。
返回值
如果应用程序处理此消息，则应返回零。
***************************************************************************
WM_MOUSEMOVE消息:光标移动时张贴到窗口。如果未捕获鼠标，则消息将发布到包含光标的窗口中。否则，该消息将发布到捕获鼠标的窗口中。
参数与WM_LBUTTONDOWNE消息相同
***************************************************************************
WM_LBUTTONUP消息:当光标在窗口的客户区域中时，用户释放鼠标左键时发布。
如果未捕获鼠标，则消息将发布到光标下方的窗口。否则，该消息将发布到捕获鼠标的窗口中。
参数与WM_LBUTTONDOWNE消息相同
*/
运行结果：
图6-1 客户区鼠标消息
总结
●实例操作方法：
1．第一种——在客户区按下左键，略微移动，再松开左键。
2．第二种——在客户区按下左键，快速移动鼠标。
●己知的问题：在客户区外释放左键，Connnect不会连接这些点，因为没收到WM_LBUTTONUP消息。
●该程序较耗时，绘制时，鼠标变沙漏形，处理WM_PAINT完后回原来的状态。用SetCursor来切换鼠标。ShowCursor隐藏或显示鼠标指针。
●窗口过程：
1．实例CONNECT.C处理了三个鼠标消息。
WM_LBUTTONDOWNE消息：按下鼠标左键时，调用InvalidateRect函数清除背景，重绘窗口。
WM_MOUSEMOVE消息：移动鼠标时，采集不超过1000个鼠标移动坐标点，保存在pt数组中，然后使用SetPixel函数绘制坐标点（系统默认黑色画笔）。
WM_LBUTTONUP消息：松开鼠标左键时，重绘窗口，但是并不清除背景。
2．处理WM_PAINT消息时，CONNECT程序需要耗费一定的时间来绘制直线，因此鼠标指针会变成等待位图。调用SetCursor函数，加载并设置鼠标位图为等待位图，显示鼠标位图。接着使用双循环将所有坐标点连接起来。然后再恢复原鼠标位图。
3．在用户释放左键时，如果鼠标指针已经移出客户区，CONNECT程序就不会连接这些点， 因为程序没有接收到WM_LBUTTONUP消息。此时如果再将鼠标移入客户区，并按下左键，CONNECT程序就会清空客户区。如果想在客户区外释放鼠标，并继续设计图形，就可以在客户区外按下鼠标的左键，再将鼠标移入客户区。
4．动手实验：处理WM_NCHITTEST消息时可以直接返回鼠标位置信息，阻止系统向所有窗口客户区和非窗口客户区发送鼠标消息。
处理WM_SYSKEYDOWN消息时，可以让所有系统键盘消息失效。
下一节我们讲述如何在非窗口客户区捕捉鼠标消息。