第4章 键盘与鼠标
键盘和鼠标是个人计算机中常用的输入设备。通过键盘可以将字母、数字、标点符号等输入计算机中,从而向计算机发出命令;鼠标可以对屏幕上的光标进行定位,并通过鼠标按钮和滚轮对光标所处位置的屏幕元素进行操作。一个应用程序应该响应用户的键盘和鼠标输入事件。
4.1 键盘
键盘上的每一个键相当于一个开关,键盘中有一个芯片对键盘上每一个键的开关状态进行扫描。按下一个键时,开关接通,该芯片会产生一个扫描码。扫描码说明了按下的键在键盘上的位置。松开按下的键会产生一个扫描码,这说明了松开的键在键盘上的位置。扫描码与具体键盘设备相关。键盘设备驱动程序解释扫描码并将其转换(映射)为虚拟键码,虚拟键码是系统定义的一个与设备无关的值。转换扫描码以后,将创建一条消息,其中包含虚拟键码和有关按键的其他信息,然后将该消息放入系统的消息队列,系统将这个键盘消息发送到相应线程的消息队列中,最后,线程的消息循环获取该消息并将其分发送给相应的窗口过程进行处理。
4.1.1 活动窗口与键盘焦点
活动窗口(Active Window)是用户当前使用的顶级窗口,同一时刻只能有一个程序窗口是活动窗口。系统将其放置在Z顺序的顶部,并突出显示其标题栏和边框。用户可以通过单击顶级窗口,或使用Alt + Tab / Alt + Esc组合键来激活顶级窗口使其成为活动窗口,可以通过调用GetActiveWindow函数获取活动窗口的句柄。还可以通过调用SetActiveWindow函数来激活顶级窗口,类似的函数还有BringWindowToTop、SwitchToThisWindow和SetForegroundWindow等,但是在某些系统中,这些函数可能达不到预期的效果。当用户正在使用一个窗口时,Windows不会强制另一个窗口到达前台,仅闪烁窗口的任务栏程序图标以通知用户。
桌面上的所有窗口共享键盘,只有活动窗口或活动窗口的子窗口才可以接收键盘输入。具有键盘焦点的窗口接收键盘消息,直到键盘焦点变为其他窗口。
当一个窗口被激活时,系统会发送WM_ACTIVATE消息。默认窗口过程DefWindowProc会处理这个消息,并将键盘焦点设置为这个活动窗口。
程序可以通过SetFocus函数为自己的窗口或子窗口设置键盘焦点:
HWND WINAPI SetFocus(_In_opt_ HWND hWnd);
函数执行成功,返回值是以前具有键盘焦点的窗口的句柄。
当键盘焦点从一个窗口更改为另一个窗口时,系统会向失去焦点的窗口发送WM_KILLFOCUS消息,然后将WM_SETFOCUS消息发送到已获得焦点的窗口。
程序可以通过调用BlockInput函数阻止键盘和鼠标输入:
BOOL WINAPI BlockInput(_In_ BOOL fBlockIt);
fBlockIt参数设置为TRUE表示阻止键盘和鼠标输入事件,设置为FALSE表示取消阻止。测试这个函数的时候请注意,因为编译运行程序会使本程序成为活动窗口,键盘和鼠标输入会失效,导致无法关闭本程序,也无法切换到其他程序,这时只能按Ctrl + Alt + Del组合键打开任务管理器来结束本进程。
4.1.2 系统击键消息和非系统击键消息
按下一个键将产生WM_KEYDOWN或WM_SYSKEYDOWN消息,释放一个键将产生WM_KEYUP或WM_SYSKEYUP消息。按键按下和按键抬起消息通常是成对出现的,如果用户按住一个键不放,则系统会生成一系列WM_KEYDOWN或WM_SYSKEYDOWN消息,直到用户释放按键时,再生成一条WM_KEYUP或WM_SYSKEYUP消息。
系统区分系统击键和非系统击键,系统击键生成系统击键消息WM_SYSKEYDOWN和WM_SYSKEYUP,非系统击键生成非系统击键消息WM_KEYDOWN和WM_KEYUP。当用户按下F10键(激活菜单栏),或键入与Alt键组合的键时,将生成系统击键消息,例如Alt + F4组合键用于关闭一个程序。系统击键主要用于访问系统菜单,系统击键消息由默认窗口过程DefWindowProc进行处理。程序的窗口过程通常不应该处理系统击键消息。
DefWindowProc不会处理非系统击键消息,因此程序窗口过程应该处理感兴趣的非系统击键消息。对于WM_KEYDOWN和WM_KEYUP消息,通常只需要处理一个即可,通常都是处理WM_KEYDOWN消息,并且通常只处理那些包含方向键、上档键Shift和功能键(F1~F12)等的虚拟键码的消息,不处理来自可显示字符键的击键消息。还记得在讲解消息循环时说过,TranslateMessage函数可以把WM_KEYDOWN消息转换为字符消息WM_CHAR,这样一来我们就可以在窗口过程中处理字符消息WM_CHAR来判断用户是按下了哪个字符按键,即有了TranslateMessage函数的帮助,对于字符按键我们不需要处理WM_KEYDOWN和WM_KEYUP消息,只需要处理字符消息WM_CHAR。
对于系统击键消息WM_SYSKEYDOWN和WM_SYSKEYUP,非系统击键消息WM_KEYDOWN和WM_KEYUP,wParam参数包含虚拟键码,用于确定哪个键被按下或释放。
lParam参数是击键消息的一些附加信息,包含消息的重复计数、扫描码、扩展键标志、状态描述码、先前键状态标志、转换状态标志等,程序通常不需要关心这些附加信息。附加信息如表4.1所示。
表4.1
| 位 | 含义 |
|---|---|
| 0~15 | 当前消息的重复计数,也就是由于用户按住键不放而自动重复击键的次数。对于WM_KEYUP和WM_SYSKEYUP消息,重复计数始终为1 |
| 16~23 | 扫描码。扫描码是与具体键盘设备相关的,其值取决于具体的键盘设备,因此程序通常会忽略扫描码,而使用与设备无关的虚拟键码 |
| 24 | 扩展键标志,如果是扩展键,则值为1,否则为0。对于扩展的101键和102键键盘,扩展键是键盘右侧的Alt和Ctrl,Ins、Del、Home、End、PageUp、PageDown和数字小键盘中的箭头键,NumLock键,Break(Ctrl + Pause)键,PrintScrn键,以及数字键盘中的/和Enter键。程序通常忽略扩展键标志 |
| 25~28 | 保留 |
| 29 | 状态描述码。状态描述码表示在生成击键消息时Alt键是否已按下。如果Alt键已按下,则该位为1;如果Alt键已释放,则该位为0。对于WM_KEYDOWN和WM_KEYUP消息该位始终为0,对于WM_SYSKEYDOWN和WM_SYSKEYUP消息该位始终为1 |
| 30 | 键先前状态标志。如果在发送消息之前键是按下的,则值为1;如果键是抬起的,则值为0。对于WM_KEYUP和WM_SYSKEYUP消息该位始终为1,对于WM_KEYDOWN和WM_SYSKEYDOWN消息该位始终为0 |
| 31 | 转换状态标志。转换状态标志表示是因为按下按键还是释放按键而产生的击键消息,对于WM_KEYDOWN和WM_SYSKEYDOWN消息该位始终为0,对于WM_KEYUP和WM_SYSKEYUP消息该位始终为1 |
4.1.3 虚拟键码
虚拟键码在WinUser.h头文件中定义。下面列出常见按键的虚拟键码,虽然虚拟键码比较多,但是在击键消息中常用的并不多。
有关鼠标按钮的虚拟键码如表4.2所示,但是请注意,击键消息中不会有鼠标按钮的虚拟键码,鼠标按钮的虚拟键码在鼠标消息中(见4.2节)。
表4.2
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_LBUTTON | 0x01 | 鼠标左键 |
| VK_RBUTTON | 0x02 | 鼠标右键 |
| VK_MBUTTON | 0x04 | 鼠标中键 |
程序可能需要处理表4.3中的一些键。但是像BackSpace键、Tab键、Enter键、Esc键和空格键,通常是在字符消息(而不是击键消息)中处理。
表4.3
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_BACK | 0x08 | BackSpace键 |
| VK_TAB | 0x09 | Tab键 |
| VK_CLEAR | 0x0C | Clear键(在NumLock键按下状态时数字小键盘中的5键) |
| VK_RETURN | 0x0D | Enter键(任意一个) |
| VK_SHIFT | 0x10 | Shift键(任意一个) |
| VK_CONTROL | 0x11 | Ctrl键(任意一个) |
| VK_MENU | 0x12 | Alt键(任意一个) |
| VK_PAUSE | 0x13 | Pause键 |
| VK_CAPITAL | 0x14 | Caps Lock键 |
| VK_ESCAPE | 0x1B | Esc键 |
| VK_SPACE | 0x20 | 空格键 |
表4.4中的一些键,前8个是较常使用的虚拟键码,现在使用这8个虚拟键码为SystemMetrics4程序添加键盘接口。
表4.4
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_PRIOR | 0x21 | PgUp键 |
| VK_NEXT | 0x22 | PgDn键 |
| VK_END | 0x23 | End键 |
| VK_HOME | 0x24 | Home键 |
| VK_LEFT | 0x25 | 左箭头键 |
| VK_UP | 0x26 | 向上箭头键 |
| VK_RIGHT | 0x27 | 右箭头键 |
| VK_DOWN | 0x28 | 向下箭头键 |
| VK_SNAPSHOT | 0x2C | Print Scrn键 |
| VK_INSERT | 0x2D | Ins键 |
| VK_DELETE | 0x2E | Del键 |
数字键和字母键的虚拟键码就是其ASCII码,不过通常是在字符消息(而不是击键消息)中处理,如表4.5所示。
表4.5
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| 0x30~0x39 | 0x30~0x39 | 0~9键 |
| 0x41~0x5A | 0x41~0x5A | A~Z键 |
左Windows键和右Windows键用于打开Windows开始菜单,Application键位于右Ctrl键的左侧,它的作用相当于鼠标右键,用来激活Windows或程序中的右键菜单,如表4.6所示。
表4.6
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_LWIN | 0x5B | 左Windows键 |
| VK_RWIN | 0x5C | 右Windows键 |
| VK_APPS | 0x5D | Application键 |
与数字小键盘中的键相对应的虚拟键码如表4.7所示。
表4.7
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_NUMPAD0~VK_NUMPAD9 | 0x60~0x69 | 数字小键盘0~9键 |
| VK_MULTIPLY | 0x6A | 数字小键盘的* |
| VK_ADD | 0x6B | 数字小键盘的+ |
| VK_SUBTRACT | 0x6D | 数字小键盘的− |
| VK_DECIMAL | 0x6E | 数字小键盘的. |
| VK_DIVIDE | 0x6F | 数字小键盘的/ |
大部分键盘只有12个功能键,不过Windows提供了24个功能键的虚拟键码,程序通常把功能键用作键盘快捷键,如表4.8所示。
表4.8
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_F1~VK_F24 | 0x70~0x87 | F1~F24键 |
| VK_NUMLOCK | 0x90 | Num Lock键 |
| VK_SCROLL | 0x91 | Scroll Lock键 |
注意,表4.9中的虚拟键码仅用于GetKeyState、GetAsyncKeyState和MapVirtualKey等函数中(稍后会介绍这些函数),击键消息中不会有这些虚拟键码。
表4.9
| 虚拟键码 | 数值 | 含义 |
|---|---|---|
| VK_LSHIFT | 0xA0 | 左Shift键 |
| VK_RSHIFT | 0xA1 | 右Shift键 |
| VK_LCONTROL | 0xA2 | 左控制键 |
| VK_RCONTROL | 0xA3 | 右控制键 |
| VK_LMENU | 0xA4 | 左Menu键 |
| VK_RMENU | 0xA5 | 右Menu键 |
打开Chapter3\SystemMetrics4项目,在WM_VSCROLL消息中添加SB_TOP和SB_BOTTOM滚动请求,分别表示垂直滚动条滚动到顶部和底部,然后添加对WM_KEYDOWN消息的处理:
case WM_VSCROLL:
si.cbSize = sizeof(SCROLLINFO);
si.fMask = SIF_ALL;
GetScrollInfo(hwnd, SB_VERT, &si);
iVertPos = si.nPos;
switch (LOWORD(wParam))
{
case SB_LINEUP:
si.nPos -= 1;
break;
case SB_LINEDOWN:
si.nPos += 1;
break;
case SB_PAGEUP:
si.nPos -= si.nPage;
break;
case SB_PAGEDOWN:
si.nPos += si.nPage;
break;
case SB_THUMBTRACK:
si.nPos = si.nTrackPos;
break;
case SB_TOP:
si.nPos = 0;
break;
case SB_BOTTOM:
si.nPos = NUMLINES - 1;
break;
}
// 设置位置,然后获取位置,如果si.nPos越界,Windows不会设置
si.cbSize = sizeof(SCROLLINFO);
si.fMask = SIF_POS;
SetScrollInfo(hwnd, SB_VERT, &si, TRUE);
GetScrollInfo(hwnd, SB_VERT, &si);
// 如果Windows更新了滚动条位置,我们更新客户区
if (iVertPos != si.nPos)
{
ScrollWindow(hwnd, 0, s_iHeight * (iVertPos - si.nPos), NULL, NULL);
UpdateWindow(hwnd);
}
return 0;
// …………
case WM_KEYDOWN:
switch (wParam)
{
case VK_UP: // 向上箭头键
SendMessage(hwnd, WM_VSCROLL, SB_LINEUP, 0);
break;
case VK_DOWN: // 向下箭头键
SendMessage(hwnd, WM_VSCROLL, SB_LINEDOWN, 0);
break;
case VK_PRIOR: // PgUp键
SendMessage(hwnd, WM_VSCROLL, SB_PAGEUP, 0);
break;
case VK_NEXT: // PgDn键
SendMessage(hwnd, WM_VSCROLL, SB_PAGEDOWN, 0);
break;
case VK_HOME: // Home键(或者Fn + PgUp键)
SendMessage(hwnd, WM_VSCROLL, SB_TOP, 0);
break;
case VK_END: // End键(或者Fn + PgDn键)
SendMessage(hwnd, WM_VSCROLL, SB_BOTTOM, 0);
break;
case VK_LEFT: // 左箭头键
SendMessage(hwnd, WM_HSCROLL, SB_LINELEFT, 0);
break;
case VK_RIGHT: // 右箭头键
SendMessage(hwnd, WM_HSCROLL, SB_LINERIGHT, 0);
break;
}
return 0;
完整代码参见Chapter4\SystemMetrics4项目。
我们把每一个WM_KEYDOWN消息转换为等同的WM_VSCROLL或WM_HSCROLL消息,这是通过给窗口过程发送假冒的WM_VSCROLL或WM_HSCROLL消息来欺骗WindowProc窗口过程实现的,使它认为收到了滚动条消息,这就避免了在WM_KEYDOWN和WM_VSCROLL或WM_HSCROLL消息中存在两份相同的滚动条处理代码。
SendMessage函数使用频率非常高。SendMessage函数用于向一个窗口发送消息,不仅可以发送给自己的窗口,还可以发送给其他程序窗口,只要获得了它们的窗口句柄:
LRESULT WINAPI SendMessage(
_In_ HWND hWnd, // 要向哪个窗口发送消息,hWnd窗口的窗口过程将接收该消息
_In_ UINT Msg, // 消息类型
_In_ WPARAM wParam, // 消息的wParam参数
_In_ LPARAM lParam); // 消息的lParam参数
如果将hWnd参数指定为HWND_BROADCAST(0xFFFF),则会将消息发送到系统中的所有顶级窗口。我们需要根据消息类型构造wParam和lParam参数。函数的返回值是窗口过程中该消息的返回值。
注意,SendMessage函数实质是去调用指定窗口的窗口过程,并且在窗口过程处理完消息之前函数不会返回,即在窗口过程处理完指定消息以后,Windows才把控制权交还给紧跟着SendMessage调用的下一条语句。
要将消息发送到线程的消息队列并立即返回,可以使用PostMessage或PostThreadMessage函数。
4.1.4 转义状态
在击键消息中,虚拟键码0x41~0x5A对应的是A~Z键,但是,通常认为按下A~Z键应该是小写字母a~z,在按下字母键的同时按下了Shift键或CapsLock键,才认为是大写字母A~Z。例如:
case WM_KEYDOWN:
if (wParam == 'a')
MessageBox(hwnd, TEXT("小写字母a"), TEXT("提示"), MB_OK);
if (wParam == 'A')
MessageBox(hwnd, TEXT("大写字母A"), TEXT("提示"), MB_OK);
return 0;
上面的代码,切换为英文输入法,按下A键,会弹出第二个消息框。
还有其他情况,例如按下A键时,如果Ctrl键也被按下,那么就是Ctrl + A组合键,这是一个快捷键。键盘快捷键通常和程序菜单一起在程序的资源脚本文件中定义,Windows会把这些键盘快捷键转换为菜单命令消息,程序不必自己去做转换。关于快捷键后面会学习。
对于产生可显示字符的击键组合,Windows在发送击键消息的同时还发送字符消息。有些键不产生字符,如Shift键、功能键、光标移动键等,对于这些键,Windows只产生击键消息。
在处理击键消息时,我们可能需要知道是否有转义键(Shift键、Ctrl 键和 Alt 键)或切换键(CapsLock键、NumLock键和ScrollLock键)被按下。可以通过调用GetKeyState函数获取击键消息发生时一个按键的状态:
SHORT WINAPI GetKeyState(_In_ int nVirtKey); // nVirtKey参数指定虚拟键码
返回值反映了指定按键的状态。如果高位为1,则指定按键为按下状态;否则指定按键为释放状态。最低位反映了指定切换键的状态。如果低位为1,则指定切换键为已切换(打开);如果低位为0,则指定切换键为未切换(未打开)。例如:
case WM_KEYDOWN:
if ((wParam == 'A' && GetKeyState(VK_SHIFT) < 0) || (wParam == 'A' && GetKeyState (VK_CAPITAL) & 1))
MessageBox(hwnd, TEXT("大写字母A"), TEXT("提示"), MB_OK);
return 0;
通常使用虚拟键码VK_SHIFT、VK_CONTROLL和VK_MENU来调用GetKeyState函数,也可以使用虚拟键码 VK_LSHIFT、VK_RSHIFT、VK_LCONTROL、VK_RCONTROL、VK_LMENU 或VK_RMENU来调用GetKeyState函数,用于确定是左侧还是右侧的Shift键、Ctrl键或Alt键被按下。
注意,GetKeyState函数并非实时检测键盘状态,它只是反映了到目前为止的键盘状态,用于确定击键消息发生时一个按键的状态。假设需要确定用户是否按下了Shift + Tab组合键,可以在处理Tab键的WM_KEYDOWN消息时,调用包含VK_SHIFT参数的GetKeyState函数。如果GetKeyState函数的返回值是负的,就可以确定在按下Tab键之前已经按下了Shift键。
如果需要确定某个按键的实时状态,可以使用GetAsyncKeyState函数:
SHORT WINAPI GetAsyncKeyState(_In_ int vKey);
4.1.5 字符消息
对于产生字符的击键,虽然可以通过使用击键消息和转义状态把击键消息转换为字符,但是这么做在其他国家的键盘上是有问题的。打开控制面板 → 语言 → 添加语言 → 俄语 → 添加,可以添加不同语言的键盘布局,然后可以通过单击任务栏的语言图标来改变当前活动程序使用的键盘。我添加了俄语键盘,切换为俄语键盘,我现在按下Shift + 3组合键,将会出现字符“№”。因此对于这类字符按键,程序通常应该处理字符消息。另外,对于Tab键、Enter键、空格键、BackSpace键、Shift键 + Enter键(换行)和Esc键,通常也是在字符消息中处理。
功能键和一些组合键经常被当作快捷键,Windows会把菜单快捷键转换为菜单命令消息(WM_COMMAND消息),所以应用程序不必自己去处理这些击键消息。
因此,程序需要处理的击键消息并不多,常见的就是方向键、PgUp键、PgDn键、Home键、End键和功能键等。当使用这些键时,可以通过GetKeyState函数检查Shift键和Ctrl键的状态,例如,Windows程序经常使用Shift键和方向键的组合来扩大文本编辑器选中的范围。
要想获取字符击键对应的具体字符,通常在消息循环中使用TranslateMessage函数。TranslateMessage函数将WM_KEYDOWN或WM_SYSKEYDOWN消息传递给键盘驱动程序,驱动程序检查消息的虚拟键码。如果虚拟键码是字符,同时还会检查Shift和CapsLock等键的状态,然后生成一个包含具体字符的字符消息。具体来说,TranslateMessage函数在处理WM_KEYDOWN消息时生成WM_CHAR或WM_DEADCHAR消息,在处理WM_SYSKEYDOWN消息时生成WM_SYSCHAR或WM_SYSDEADCHAR消息。如果窗口处于活动状态但没有键盘焦点,则按下的任何键都将生成WM_SYSCHAR、WM_SYSKEYDOWN或WM_SYSKEYUP消息。
字符消息的wParam参数包含具体的字符,lParam参数的内容与被转换为字符消息的击键消息的lParam参数的内容相同。程序通常可以忽略除WM_CHAR之外的其他字符消息,其他所有字符消息由DefWindowProc函数执行默认处理。
在某些非英语键盘上有一些用于给字母添加音调的按键,这类按键称为死键,死键产生的消息就是死字符消息。TranslateMessage函数在处理来自死键的WM_KEYDOWN消息时生成WM_DEADCHAR消息,在处理与Alt键组合按下的死键的WM_SYSKEYDOWN消息时生成WM_SYSDEADCHAR消息。程序通常会忽略WM_SYSDEADCHAR消息。
4.1.6 模拟击键消息
有两种方法可以很方便地实现模拟击键消息。一是使用SendMessage / PostMessage函数发送WM_KEYDOWN等消息。SendMessage和PostMessage函数的用法相同,不同的是PostMessage函数将消息发送到线程的消息队列并立即返回,不会等待窗口过程把消息处理完毕。我们已经用过SendMessage函数,接下来练习一下PostMessage函数。
二是使用keybd_event模拟击键事件。keybd_event函数的原型定义如下:
VOID WINAPI keybd_event(
_In_ BYTE bVk, // 虚拟键码
_In_ BYTE bScan, // 按键的扫描码,可以设置为0
_In_ DWORD dwFlags, // 标志位
_In_ ULONG_PTR dwExtraInfo);// 与击键相关的附加的32位值,可以设置为0
参数dwFlags是标志位,如果设置为KEYEVENTF_KEYUP,则表示按键抬起;如果设置为0,则表示按键按下。
keybd_event函数合成一次击键事件,并不关心由谁来处理它。系统捕捉到击键事件后会转换为键盘消息WM_KEYDOWN或WM_KEYUP分发给当前系统中拥有键盘焦点的应用程序。
我的笔记本只有84个键盘,没有Home和End按键。我想使用数字按键1代替Home按键的效果,数字按键2代替End按键的效果。打开Chapter4\SystemMetrics4项目,添加对WM_CHAR消息的处理:
case WM_CHAR:
switch (wParam)
{
case '1':
PostMessage(hwnd, WM_KEYDOWN, VK_HOME, 0);
break;
case '2':
keybd_event(VK_END, 0, 0, 0);
keybd_event(VK_END, 0, KEYEVENTF_KEYUP, 0);
break;
}
return 0;
使用keybd_event模拟击键消息,需要注意的是对于每一个按键必须成对使用,第一次表示按下,第二次带有KEYEVENTF_KEYUP标志表示释放按键。例如,如果需要模拟Win + R打开系统的“运行”程序,可以按如下方式使用keybd_event函数:
keybd_event(VK_LWIN, 0, 0, 0);
keybd_event('R', 0, 0, 0);
keybd_event('R', 0, KEYEVENTF_KEYUP, 0);
keybd_event(VK_LWIN, 0, KEYEVENTF_KEYUP, 0);
有时候,在按键按下和抬起之间可能需要暂停一会,例如模拟Alt + Tab组合键:
keybd_event(VK_MENU, 0, 0, 0);
keybd_event(VK_TAB, 0, 0, 0);
Sleep(3000); // 让切换应用程序窗口停留3s
keybd_event(VK_TAB, 0, KEYEVENTF_KEYUP, 0);
keybd_event(VK_MENU, 0, KEYEVENTF_KEYUP, 0);
Sleep函数可以暂停程序的执行:
VOID WINAPI Sleep(_In_ DWORD dwMilliseconds); // 暂停执行的时间间隔,以毫秒为单位
微软建议使用SendInput函数代替keybd_event函数。SendInput函数既可以模拟键盘输入也可以模拟鼠标输入:
UINT WINAPI SendInput(
_In_ UINT nInputs, // pInputs数组中的结构数
_In_ LPINPUT pInputs, // INPUT结构的数组,每个结构表示一个键盘或鼠标输入事件
_In_ int cbSize); // INPUT结构的大小,以字节为单位
参数pInputs是一个INPUT结构的数组,每个结构表示一个键盘或鼠标输入事件。INPUT结构在WinUser.h头文件中定义如下:
typedef struct tagINPUT {
DWORD type; // 输入事件的类型
union
{
MOUSEINPUT mi; // MOUSEINPUT结构
KEYBDINPUT ki; // KEYBDINPUT结构
HARDWAREINPUT hi; // HARDWAREINPUT结构
};
} INPUT, *PINPUT, FAR* LPINPUT;
- 字段type指定输入事件的类型,该字段可以是表4.10所示的值之一。
表4.10
| 常量 | 含义 |
|---|---|
| INPUT_MOUSE | 该事件是鼠标事件,使用mi结构 |
| INPUT_KEYBOARD | 该事件是键盘事件,使用ki结构 |
| INPUT_HARDWARE | 该事件是硬件事件,使用hi结构 |
- mi、ki、hi都是结构体,分别指定鼠标、键盘和硬件事件的具体信息。硬件事件指的是键盘或鼠标以外的输入设备生成的消息。这几个结构比较简单,如果需要使用SendInput函数请自行查阅MSDN。
4.1.7 插入符号
插入符号是窗口客户区中闪烁的水平或垂直短线、实心块或位图,通常表示插入文本或图形的位置,很多人习惯上叫作光标。当窗口具有键盘焦点或处于活动状态时可以创建、显示插入符号;当失去键盘焦点或变为非活动状态时应该销毁插入符号。
CreateCaret函数用于为一个窗口创建指定形状的插入符号:
BOOL WINAPI CreateCaret(
_In_ HWND hWnd, // 拥有插入符号的窗口的句柄
_In_opt_ HBITMAP hBitmap, // 位图句柄,用于定义插入符号的形状
_In_ int nWidth, // 插入符号的宽度,设置为0表示使用系统定义的窗口边框宽度
_In_ int nHeight);// 插入符号的高度,设置为0表示使用系统定义的窗口边框高度
参数hBitmap用于定义插入符号的形状。如果设置为NULL,则插入符号为黑色实心;如果设置为(HBITMAP)1,则插入符号为灰色网线形状;如果设置为位图句柄,则插入符号是指定的位图。位图句柄可以通过LoadBitmap函数加载。如果hBitmap参数指定为位图句柄,则CreateCaret函数会忽略nWidth和nHeight参数的值。位图有自己的宽度和高度。
插入符号是隐藏的,必须调用ShowCaret函数才能使插入符号可见,然后它会自动闪烁:
BOOL WINAPI ShowCaret(_In_opt_ HWND hWnd);
处理窗口重绘消息时通常需要调用HideCaret函数隐藏插入符号:
BOOL WINAPI HideCaret(_In_opt_ HWND hWnd);
重绘消息处理完毕再调用ShowCaret函数显示插入符号。隐藏具有累积效果,如果程序连续3次调用HideCaret函数,那么必须连续调用ShowCaret函数3次才可以再次显示插入符号。
SetCaretBlinkTime函数可以修改插入符号的闪烁时间,这会影响到其他程序,即其他程序也会使用修改后的闪烁时间:
BOOL WINAPI SetCaretBlinkTime(_In_ UINT uMSeconds); // 毫秒
SetCaretPos函数可以移动插入符号的位置:
BOOL WINAPI SetCaretPos(
_In_ int X, // 插入符号的新X坐标
_In_ int Y); // 插入符号的新Y坐标
当失去键盘焦点或变为非活动状态时应该调用DestroyCaret函数销毁插入符号:
BOOL WINAPI DestroyCaret(void);
本节实现一个简单的打字程序,篇幅关系没有实现文本选择功能,其实这也简单,设置一下文本颜色与背景色就可以了,方向键仅简单演示了左箭头键。程序运行效果如原书的图4.1所示。
具体代码参见Chapter4\Typer项目。
ZeroMemory宏可以把指定的内存块填充为0(清零),新申请的内存块通常需要初始化为全0:
void ZeroMemory(
[in] PVOID Destination, // 指向要填充零的内存块的起始地址的指针
[in] SIZE_T Length); // 要填充为零的内存块的大小,以字节为单位
ZeroMemory宏的定义如下:
#define ZeroMemory RtlZeroMemory
#define RtlZeroMemory(Destination,Length) memset((Destination),0,(Length))
实质上还是调用了C/C++运行库函数memset。
4.2 鼠标
目前市面上各种各样的鼠标琳琅满目,不过按外形可以分为两键鼠标、三键鼠标、滚轴鼠标、感应鼠标和五键鼠标等。滚轴鼠标和感应鼠标在笔记本计算机中应用很普遍。往不同方向转动鼠标中间的小圆球,或在感应板上移动手指,光标就会向相应的方向移动。当光标到达预定位置时,按一下鼠标或感应板,即可执行相应操作。
当用户移动鼠标时,系统在屏幕上显示一个称为鼠标光标的位图,鼠标光标中包含一个称为热点的单像素点,热点确定光标的位置。各种系统预定义光标的形状在讲解注册窗口类WNDCLASSEX结构的hCursor字段时说过。IDC_ARROW标准箭头光标的热点位于箭头的最上部,IDC_CROSS十字线光标的热点位于十字线的中心。除了系统预定义的光标形状,后面还会学习自定义光标。对于接收鼠标消息,不要求窗口必须处于活动状态或具有输入焦点。发生鼠标事件时,光标位置下面的窗口通常会接收到鼠标消息。
对于三键鼠标来说,3个按钮分别被称为左键、中键和右键。对鼠标按钮的操作包括单击、双击、移动和拖动。
-
单击:按下鼠标按钮,然后松开。
-
双击:连续两次快速单击鼠标按钮。
-
移动:改变鼠标光标的位置。
-
拖动:按下鼠标按钮不放,并移动鼠标光标。
Windows支持带有5个按钮的鼠标,五键鼠标除了左、中、右按钮外,还有XBUTTON1和XBUTTON2,浏览器中通常会使用这两个按钮实现网页的前进和后退功能。
要为习惯使用左手的用户配置鼠标,程序可以通过调用SwapMouseButton函数或SystemParametersInfo函数(使用SPI_SETMOUSEBUTTONSWAP标志)来反转鼠标左键和右键,但请注意,鼠标是共享资源,因此反转鼠标左键和右键会影响其他所有程序。程序通常没有必要提供这个功能,因为控制面板已经为用户提供了习惯左手还是右手,以及启用单击锁定、双击速度、光标移动速度等丰富的功能,具体参见控制面板 → 鼠标(打开控制面板以后,查看方式选择小图标)。
4.2.1 客户区鼠标消息
当用户移动、按下或释放鼠标按钮时,会生成鼠标输入事件。系统会将鼠标输入事件转换为消息,然后发送到线程的消息队列中。当用户在窗口的客户区内移动光标时,系统会不断发送一系列WM_MOUSEMOVE消息;当用户在客户区内按下或释放鼠标按钮时,会发送表4.11所示的消息之一。
表4.11
| 消息类型 | 含义 |
|---|---|
| WM_LBUTTONDOWN | 按下鼠标左键 |
| WM_LBUTTONUP | 鼠标左键被释放 |
| WM_LBUTTONDBLCLK | 双击鼠标左键 |
| WM_MBUTTONDOWN | 按下鼠标中键 |
| WM_MBUTTONUP | 鼠标中键被释放 |
| WM_MBUTTONDBLCLK | 双击鼠标中键 |
| WM_RBUTTONDOWN | 按下鼠标右键 |
| WM_RBUTTONUP | 鼠标右键被释放 |
| WM_RBUTTONDBLCLK | 双击鼠标右键 |
分别是左键、中键和右键的按下、释放和双击消息。鼠标按下和鼠标抬起消息是成对出现的,例如一次鼠标左键单击事件会生成WM_LBUTTONDOWN和WM_LBUTTONUP消息。
此外,程序可以通过调用TrackMouseEvent函数让系统发送另外两条消息。当鼠标光标悬停在客户区一段时间后发送WM_MOUSEHOVER消息,当鼠标光标离开客户区时发送WM_MOUSELEAVE消息:
BOOL WINAPI TrackMouseEvent(_Inout_ LPTRACKMOUSEEVENT lpEventTrack); // TRACKMOUSEEVENT结构
参数lpEventTrack是一个指向TRACKMOUSEEVENT结构的指针,在WinUser.h头文件中定义如下:
typedef struct tagTRACKMOUSEEVENT {
DWORD cbSize; // 结构的大小
DWORD dwFlags; // 标志位
HWND hwndTrack; // 要跟踪的窗口的句柄
DWORD dwHoverTime; // 悬停超时,以毫秒为单位
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;
- 参数dwFlags指定标志位,可以是表4.12所示的值的组合。
表4.12
| 常量 | 含义 |
|---|---|
| TME_CANCEL | 取消先前的跟踪请求,还需要同时指定要取消的跟踪类型,例如,要取消悬停跟踪,需要指定为`TME_CANCEL |
| TME_HOVER | 当鼠标光标悬停在客户区一段时间后发送WM_MOUSEHOVER消息,该消息只会触发一次。如果需要再次发送该消息,则必须重新调用TrackMouseEvent函数 |
| TME_LEAVE | 当鼠标光标离开客户区时发送WM_MOUSELEAVE消息,该消息产生以后,所有由TrackMouseEvent函数设置的鼠标跟踪请求(悬停和离开)都会被取消。请注意,如果鼠标不在窗口的客户区内,会立即发送WM_MOUSELEAVE消息 |
| TME_NONCLIENT | 当鼠标光标在非客户区悬停一段时间或离开时发送非客户区鼠标消息WM_NCMOUSEHOVER或WM_NCMOUSELEAVE消息,用法和前两个类似 |
- 参数dwHoverTime指定悬停超时(如果在dwFlags参数中指定了TME_HOVER),以毫秒为单位,可以设置为HOVER_DEFAULT,表示使用系统默认的悬停超时,后面的章节会用到该函数。
客户区鼠标消息的wParam参数包含鼠标事件发生时其他鼠标按钮以及Ctrl和Shift键的状态标志。wParam参数可以是表4.13所示的值的组合。
表4.13
| 常量 | 含义 |
|---|---|
| MK_LBUTTON | 鼠标左键已按下 |
| MK_MBUTTON | 鼠标中键已按下 |
| MK_RBUTTON | 鼠标右键已按下 |
| MK_CONTROL | Ctrl键已按下 |
| MK_SHIFT | Shift键已按下 |
| MK_XBUTTON1 | 第一个X按钮已按下 |
| MK_XBUTTON2 | 第二个X按钮已按下 |
例如,当接收到WM_LBUTTONDOWN消息时,如果wParam & MK_SHIFT的值为TRUE(非零),则表示用户按下左键的同时还按下了Shift键。
客户区鼠标消息的lParam参数表示鼠标事件发生时光标热点的位置,lParam参数的低位字表示热 点的X坐标,高位字表示Y坐标,相对于客户区左上角。可以按如下方式获取光标热点的X和Y坐标:
int xPos, yPos;
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
GET_X_LPARAM和GET_Y_LPARAM宏在Windowsx.h头文件中定义如下:
#define GET_X_LPARAM(lp) ((int)(short)LOWORD(lp))
#define GET_Y_LPARAM(lp) ((int)(short)HIWORD(lp))
鼠标光标的坐标有时候可能是负值,因此不能使用LOWORD或HIWORD宏来提取光标位置的X坐标和Y坐标。LOWORD和HIWORD宏返回的是WORD类型,而WORD被定义为无符号短整型:
typedef unsigned short WORD;
关于鼠标双击消息(WM_LBUTTONDBLCLK、WM_MBUTTONDBLCLK、WM_RBUTTONDBLCLK),在讲解WNDCLASSEX结构的style字段时说过,必须指定CS_DBLCLKS样式才可以接收鼠标双击消息。鼠标双击消息通常会连续生成4条消息,例如,双击鼠标左键会生成以下消息序列:
WM_LBUTTONDOWN
WM_LBUTTONUP
WM_LBUTTONDBLCLK
WM_LBUTTONUP
4.2.2 非客户区鼠标消息
窗口的非客户区包括标题栏、菜单栏、菜单、边框、滚动条、最小化按钮和最大化按钮等,当在窗口的非客户区内发生鼠标事件时,会生成非客户区鼠标消息,非客户区鼠标消息的名称包含字母NC。例如,当光标在非客户区中移动时会生成WM_NCMOUSEMOVE消息,当光标在非客户区时按下鼠标左键会生成WM_NCLBUTTONDOWN消息。表4.14列出了消息。
表4.14
| 消息类型 | 含义 |
|---|---|
| WM_NCLBUTTONDOWN | 按下鼠标左键 |
| WM_NCLBUTTONUP | 鼠标左键被释放 |
| WM_NCLBUTTONDBLCLK | 双击鼠标左键 |
| WM_NCMBUTTONDOWN | 按下鼠标中键 |
| WM_NCMBUTTONUP | 鼠标中键被释放 |
| WM_NCMBUTTONDBLCLK | 双击鼠标中键 |
| WM_NCRBUTTONDOWN | 按下鼠标右键 |
| WM_NCRBUTTONUP | 鼠标右键被释放 |
| WM_NCRBUTTONDBLCLK | 双击鼠标右键 |
| WM_NCMOUSEMOVE | 移动光标 |
除此之外,通过调用TrackMouseEvent函数(dwFlags参数包含TME_NONCLIENT标志),当鼠标光标在非客户区悬停一段时间或离开时会发送WM_NCMOUSEHOVER或WM_NCMOUSELEAVE消息。
非客户区鼠标消息由DefWindowProc函数执行默认处理,例如,当鼠标光标移动到窗口的边框时,DefWindowProc函数会处理非客户区鼠标消息,将光标更改为双向箭头。如果没有特殊需求,则程序不需要自己处理非客户区鼠标消息;如果实在需要处理,则处理完以后还应该转交给DefWindowProc函数。请看如下代码:
case WM_NCLBUTTONDOWN:
case WM_NCLBUTTONUP:
case WM_NCLBUTTONDBLCLK:
return 0;
这么做的结果是,无法使用系统菜单,无法使用最小化、最大化、关闭按钮,无法打开程序的菜单,无法通过拖拉边框调整窗口大小等。
非客户区鼠标消息的wParam参数包含命中测试值。每当发生鼠标事件时(包括客户区和非客户区鼠标事件),系统都会先发送WM_NCHITTEST消息,DefWindowProc函数会检查鼠标事件发生时的鼠标光标热点坐标以确定是发送客户区还是非客户区鼠标消息,随后还可能发送WM_SYSCOMMAND消息,DefWindowProc函数处理WM_NCHITTEST消息以后的返回值是指明光标热点位置的命中测试值。命中测试值可以是表4.15所示的值之一。
表4.15
| 命中测试值 | 光标热点位置 |
|---|---|
| HTTOP | 在窗口的上水平边框中 |
| HTBOTTOM | 在窗口的下水平边框中 |
| HTLEFT | 在窗口的左边框 |
| HTRIGHT | 在窗口的右边框 |
| HTTOPLEFT | 在窗口边框的左上角 |
| HTTOPRIGHT | 在窗口边框的右上角 |
| HTBOTTOMLEFT | 在窗口边框的左下角 |
| HTBOTTOMRIGHT | 在窗口边框的右下角 |
| HTHSCROLL | 在水平滚动条中 |
| HTVSCROLL | 在垂直滚动条中 |
| HTBORDER | 在窗口的边框中,该窗口边框不可调整大小 |
| HTCAPTION | 在标题栏中 |
| HTCLIENT | 在客户区中 |
| HTCLOSE | 在关闭按钮中 |
| HTHELP | 在帮助按钮中 |
| HTSYSMENU | 在系统菜单或子窗口中的关闭按钮中 |
| HTMENU | 在菜单中 |
| HTMAXBUTTON或HTZOOM | 在最大化按钮中 |
| HTMINBUTTON或HTREDUCE | 在最小化按钮中 |
| HTTRANSPARENT | 在被另一个窗口覆盖的窗口中 |
| HTNOWHERE | 在屏幕背景中或在窗口之间的分界线上 |
| HTERROR | 在屏幕背景中或在窗口之间的分界线上,会产生系统蜂鸣声以指示错误 |
例如,如果鼠标事件发生时光标热点位于窗口的客户区中,则DefWindowProc函数将命中测试值HTCLIENT返回给窗口过程,窗口过程将HTCLIENT返回给系统,系统将光标热点的屏幕坐标转换为客户区坐标,然后发送相应的客户区鼠标消息;如果光标热点位于窗口的非客户区中,则DefWindowProc函数会返回其他命中测试值,窗口过程将其返回给系统,系统将命中测试值放在消息的wParam参数中,将光标热点的屏幕坐标放在lParam参数中,然后发送非客户区鼠标消息。
也可能发送WM_SYSCOMMAND消息。例如,大家都知道双击程序窗口左上角的系统菜单图标可以关闭程序,双击事件首先产生WM_NCHITTEST消息,鼠标光标位于系统菜单图标之上,所以DefWindowProc函数处理WM_NCHITTEST消息以后返回HTSYSMENU;系统发送WM_NCLBUTTONDBLCLK消息,其中wParam参数等于HTSYSMENU;DefWindowProc函数处理WM_NCLBUTTONDBLCLK消息,然后发送WM_SYSCOMMAND消息,其中wParam参数等于SC_CLOSE(当用户手动单击系统菜单中的“关闭”按钮时,也是产生WM_SYSCOMMAND消息);DefWindowProc函数处理WM_SYSCOMMAND消息,并发送WM_CLOSE消息;DefWindowProc处理WM_CLOSE消息,向窗口过程发送一个WM_DESTROY消息,DefWindowProc函数不会处理WM_DESTROY消息,这个消息需要我们自己处理,这一点请看2.2.5节的窗口关闭过程。
非客户区鼠标消息的lParam参数包含鼠标光标热点的X坐标和Y坐标。与客户区鼠标消息不同,该坐标是屏幕坐标而不是客户区坐标,相对于屏幕左上角。可以使用GET_X_LPARAM(lParam)和GET_Y_LPARAM(lParam)宏分别提取光标热点的X和Y坐标。通过调用ScreenToClient和ClientToScreen函数可以将屏幕坐标与客户区坐标相互转换。如果一个屏幕坐标点位于窗口客户区的左侧或上方,那么转换成客户区坐标后,X值或Y值会是负数。
4.2.3 X按钮消息
当用户按下或释放XBUTTON1或XBUTTON2按钮时会发送WM_XBUTTON或WM_NCXBUTTON消息,这些消息的wParam参数的高位字包含一个标志,指示用户按下或释放了哪个X按钮。
当用户在窗口的客户区中按下、释放或双击第一个或第二个X按钮时会发送WM_XBUTTONDOWN、WM_XBUTTONUP或WM_XBUTTONDBLCLK消息。
- 这些消息的wParam参数的低位字包含鼠标事件发生时其他鼠标按钮以及Ctrl和Shift键的状态标志,可用的标志和客户区鼠标消息的wParam参数相同。 wParam参数的高位字指明用户是按下、释放或双击了哪个X按钮。可以是表4.16所示的值之一。
表4.16
| 常量 | 含义 |
|---|---|
| XBUTTON1 | 按下、释放或双击了第一个X按钮 |
| XBUTTON2 | 按下、释放或双击了第二个X按钮 |
可以使用以下代码提取wParam参数中的信息:
fwKeys = GET_KEYSTATE_WPARAM(wParam); // 其他鼠标按钮以及Ctrl和Shift键的状态标志
fwButton = GET_XBUTTON_WPARAM(wParam); // 按下、释放或双击了哪个X按钮
-
这些消息的lParam参数表示鼠标事件发生时光标热点的位置。lParam参数的低位字表示热点的X坐标,高位字表示Y坐标,相对于客户区左上角。可以使用GET_X_LPARAM(lParam)和GET_Y_LPARAM(lParam)宏分别提取光标热点的X和Y坐标。 当用户在窗口的非客户区中按下、释放或双击第一个或第二个X按钮时会发送WM_NCXBUTTONDOWN、WM_NCXBUTTONUP或WM_NCXBUTTONDBLCLK消息。
-
这些消息的wParam参数的低位字包含DefWindowProc函数在处理WM_NCHITTEST消息时返回的命中测试值,可用的命中测试值与非客户区鼠标消息的wParam参数相同;高位字表示按下了哪个X按钮,即XBUTTON1或XBUTTON2。 可以使用以下代码提取wParam参数中的信息:
nHittest = GET_NCHITTEST_WPARAM(wParam); // 命中测试值
fwButton = GET_XBUTTON_WPARAM(wParam); // 按下、释放或双击了哪个X按钮
- 这些消息的lParam参数包含鼠标事件发生时光标热点的X坐标和Y坐标,坐标相对于屏幕的左上角。可以使用GET_X_LPARAM(lParam)和GET_Y_LPARAM(lParam)宏分别提取光标热点的X和Y坐标。
请注意,对于鼠标左键、中键或右键的客户区鼠标消息,窗口过程处理完以后应返回0;但是对于X按钮的客户区消息和非客户区消息处理完毕以后应返回TRUE。对于X按钮消息,DefWindowProc函数会执行默认处理,处理以后DefWindowProc函数会向窗口发送WM_APPCOMMAND消息。DefWindowProc函数还会处理WM_APPCOMMAND消息,关于WM_APPCOMMAND消息参见MSDN。
4.2.4 鼠标光标函数
GetCursorPos函数可以获取鼠标光标的当前位置:
BOOL WINAPI GetCursorPos(_Out_ LPPOINT lpPoint); // 在lpPoint结构中返回鼠标光标位置,屏幕坐标
SetCursorPos函数可以将鼠标光标移动到指定的位置:
BOOL WINAPI SetCursorPos(_In_ int X, _In_ int Y);// 屏幕坐标
调用ShowCursor函数可以显示或隐藏鼠标光标:
int WINAPI ShowCursor(_In_ BOOL bShow); //设置为TRUE则显示计数加1,设置为FALSE,则显示计数减1
系统维护一个鼠标光标显示计数器,用于确定是否应该显示光标,仅当显示计数大于或等于0时才显示光标。如果计算机安装了鼠标,则初始显示计数为0,如果未安装鼠标,则初始显示计数为−1。
GetCursorInfo函数可以获取鼠标光标的显示或隐藏状态、光标句柄和坐标:
BOOL WINAPI GetCursorInfo(_Inout_ PCURSORINFO pci); // 在这个CURSORINFO结构中返回鼠标光标信息
pci参数是一个指向CURSORINFO结构的指针,该结构在WinUser.h头文件中定义如下:
typedef struct tagCURSORINFO
{
DWORD cbSize; // 该结构的大小
DWORD flags; // 光标状态标志,如果是0表示光标被隐藏,如果是CURSOR_SHOWING(1)表示正在
// 显示
HCURSOR hCursor; // 光标句柄
POINT ptScreenPos;// 接收光标坐标的POINT结构,屏幕坐标
} CURSORINFO, *PCURSORINFO, *LPCURSORINFO;
SetCursor函数可以设置光标的形状:
HCURSOR WINAPI SetCursor(_In_opt_ HCURSOR hCursor); // 光标的句柄
参数hCursor指定光标的句柄,这个句柄可以由LoadCursor、CreateCursor或LoadImage函数返回。如果hCursor参数设置为NULL,则从屏幕上删除光标。函数返回值是前一个光标的句柄。例如调用SetCursor(LoadCursor(NULL, IDC_CROSS));可以把光标形状设置为系统预定义光标十字线形状,关于创建自定义光标后面再讲。
需要注意的是,鼠标光标是共享资源,仅当鼠标光标位于我们程序的客户区内时,才应该调用SetCursorPos、ShowCursor、SetCursor等函数改变鼠标光标,在光标离开客户区之前应该恢复为先前的状态。
ClipCursor函数可以将鼠标光标的活动范围限制在指定的矩形区域以内:
BOOL WINAPI ClipCursor(_In_opt_ const RECT *lpRect); // 屏幕坐标,lpRect设置为NULL,
// 则可以自由移动
某些加密程序为了防止用户调试自己的程序或者其他非法操作,经常限制用户的鼠标只能在自己程序的窗口范围内活动,例如下面的代码可以实现这个目的:
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
RECT rect;
switch (uMsg)
{
case WM_CREATE:
SetTimer(hwnd, 1, 100, NULL);
return 0;
case WM_TIMER:
GetWindowRect(hwnd, &rect);
ClipCursor(&rect);
return 0;
case WM_DESTROY:
ClipCursor(NULL);
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
在WM_CREATE消息中调用SetTimer函数创建了一个计时器,每隔100 ms向窗口过程发送一个WM_TIMER消息。计时器将在第5章讲解。
4.2.5 鼠标捕获
本节实现一个鼠标绘制矩形的示例,用鼠标绘图需要跟踪鼠标光标的位置,跟踪光标通常涉及处理WM_LBUTTONDOWN、WM_MOUSEMOVE和WM_LBUTTONUP消息。通过记录WM_LBUTTONDOWN消息的lParam参数中提供的光标位置来确定起点,鼠标移动时会不断产生一系列WM_MOUSEMOVE消息,通常也应该处理WM_MOUSEMOVE消息以实时反映所绘制图形的变化,最后,处理WM_LBUTTONUP消息结束绘制。DrawRectangle程序的运行效果如原书的图4.2所示。
DrawRectangle.cpp源文件的内容如下所示:
#include <Windows.h>
#include <Windowsx.h>
// 函数声明
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
VOID DrawFrame(HWND hwnd, POINT ptLeftTop, POINT ptRightBottom);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
WNDCLASSEX wndclass;
TCHAR szClassName[] = TEXT("MyWindow");
TCHAR szAppName[] = TEXT("DrawRectangle");
HWND hwnd;
MSG msg;
wndclass.cbSize = sizeof(WNDCLASSEX);
wndclass.style = CS_HREDRAW | CS_VREDRAW;
wndclass.lpfnWndProc = WindowProc;
wndclass.cbClsExtra = 0;
wndclass.cbWndExtra = 0;
wndclass.hInstance = hInstance;
wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);
wndclass.hCursor = LoadCursor(NULL, IDC_ARROW);
wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
wndclass.lpszMenuName = NULL;
wndclass.lpszClassName = szClassName;
wndclass.hIconSm = NULL;
RegisterClassEx(&wndclass);
hwnd = CreateWindowEx(0, szClassName, szAppName, WS_OVERLAPPEDWINDOW,
CW_USEDEFAULT, CW_USEDEFAULT, 400, 300, NULL, NULL, hInstance, NULL);
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
while (GetMessage(&msg, NULL, 0, 0) != 0)
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return msg.wParam;
}
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
HDC hdc;
PAINTSTRUCT ps;
static POINT ptLeftTop, ptRightBottom; // 矩形的左上角和右下角坐标
static BOOL bStarting;
switch (uMsg)
{
case WM_LBUTTONDOWN:
//SetCapture(hwnd);
SetCursor(LoadCursor(NULL, IDC_CROSS));
// 初始化新矩形的左上角和右下角坐标
ptLeftTop.x = ptRightBottom.x = GET_X_LPARAM(lParam);
ptLeftTop.y = ptRightBottom.y = GET_Y_LPARAM(lParam);
bStarting = TRUE;
return 0;
case WM_MOUSEMOVE:
if (bStarting)
{
SetCursor(LoadCursor(NULL, IDC_CROSS));
// 先擦除上一次WM_MOUSEMOVE消息所画的矩形,WM_MOUSEMOVE消息会不断产生
DrawFrame(hwnd, ptLeftTop, ptRightBottom);
// 新矩形的右下角坐标
ptRightBottom.x = GET_X_LPARAM(lParam);
ptRightBottom.y = GET_Y_LPARAM(lParam);
// 绘制新矩形
DrawFrame(hwnd, ptLeftTop, ptRightBottom);
}
return 0;
case WM_LBUTTONUP:
if (bStarting)
{
// 擦除WM_MOUSEMOVE消息中所画的最后一个矩形
DrawFrame(hwnd, ptLeftTop, ptRightBottom);
// 最终矩形的右下角坐标
ptRightBottom.x = GET_X_LPARAM(lParam);
ptRightBottom.y = GET_Y_LPARAM(lParam);
SetCursor(LoadCursor(NULL, IDC_ARROW));
bStarting = FALSE;
//ReleaseCapture();
// 绘制最终的矩形
InvalidateRect(hwnd, NULL, TRUE);
}
return 0;
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps);
Rectangle(hdc, ptLeftTop.x, ptLeftTop.y, ptRightBottom.x, ptRightBottom.y);
EndPaint(hwnd, &ps);
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
VOID DrawFrame(HWND hwnd, POINT ptLeftTop, POINT ptRightBottom)
{
HDC hdc = GetDC(hwnd);
SelectObject(hdc, GetStockObject(NULL_BRUSH));
SetROP2(hdc, R2_NOT);
Rectangle(hdc, ptLeftTop.x, ptLeftTop.y, ptRightBottom.x, ptRightBottom.y);
SelectObject(hdc, GetStockObject(WHITE_BRUSH));
ReleaseDC(hwnd, hdc);
}
具体代码参见Chapter4\DrawRectangle项目。用户按下鼠标左键,鼠标光标的当前位置作为要绘制矩形的左上角和右下角坐标;然后不断拖动鼠标产生WM_MOUSEMOVE消息,将矩形的右下角坐标重设为鼠标光标的当前位置,然后画出矩形的边框;当用户释放鼠标时,绘制最终的矩形。
但是存在一个问题,在程序窗口的客户区内按下鼠标左键,然后移动鼠标到窗口以外时,程序将停止接收WM_MOUSEMOVE消息,现在释放鼠标,由于鼠标落在客户区以外,所以程序没有接收到WM_BUTTONUP消息。再将鼠标移回程序窗口的客户区,窗口过程仍然会认为鼠标按钮处于按下的状态,程序现在不知道该如何运行了。
鼠标按下和鼠标抬起消息是成对出现的,这一点没错,但是,在一个窗口没有接收WM_LBUTTONDOWN消息的情况下,该窗口的窗口过程可能会接收到WM_LBUTTONUP消息,例如用户在其他窗口内按下鼠标,再移动到我们的程序窗口,然后释放,此时就会发生这种情况;如果用户在程序窗口按下鼠标,然后移动鼠标到另一个窗口再释放,则窗口过程会接收到WM_LBUTTONDOWN消息,但接收不到WM_LBUTTONUP消息。
把WM_LBUTTONDOWN消息中的SetCapture(hwnd);注释去掉,把WM_LBUTTONUP消息中的ReleaseCapture();注释也去掉,程序工作就会正常。下面解释这两个函数。
SetCapture函数为指定窗口设置鼠标捕获,然后该窗口可以接收所有鼠标消息,直到调用ReleaseCapture函数或为其他窗口设置了鼠标捕获:
HWND WINAPI SetCapture(_In_ HWND hWnd); // 为hWnd窗口捕获鼠标
函数返回值是先前捕获鼠标的窗口的句柄,一次只能有一个窗口来捕获鼠标。
不再需要鼠标捕获的时候必须调用ReleaseCapture函数释放鼠标捕获:
BOOL WINAPI ReleaseCapture(void);
为指定窗口设置鼠标捕获以后,鼠标消息总是以客户区鼠标消息的形式出现。即使鼠标位于窗口的非客户区,参数lParam表示的鼠标光标也始终相对于客户区。当鼠标位于客户区之外的左方或上方时,X和Y坐标会是负值。不要随便为一个程序窗口设置鼠标捕获,通常只有当鼠标在客户区内被按下时,程序才应该捕获鼠标;当释放鼠标按钮时,应该立即停止捕获。
还可以使用ClipCursor函数在绘制矩形期间将光标活动区域限制在客户区范围以内,例如在WM_LBUTTONDOWN消息中添加以下代码:
case WM_LBUTTONDOWN:
//SetCapture(hwnd);
GetClientRect(hwnd, &rectClient); // 获取客户区坐标
ClientToScreen(hwnd, LPPOINT(&rectClient));
ClientToScreen(hwnd, LPPOINT(&rectClient) + 1);
ClipCursor(&rectClient);
不要忘了在WM_LBUTTONUP消息中添加以下代码还鼠标光标自由之身:
ClipCursor(NULL);
这样的处理方式也很合理。
有一点需要注意,RECT结构有一个特性,就是RECT结构通常不包含右边缘和底边缘,大家可以测试一下,将光标活动区域限制在客户区范围内以后,最右侧和最底部是无法绘制到的。如果需要,则可以在获取客户区的矩形尺寸以后再为其right和bottom字段额外加1。有的函数处理方式则不同,例如FillRect函数是可以填充指定RECT结构的右边缘和底边缘的。
4.2.6 鼠标滚轮
按下或释放鼠标滚轮会发送WM_MBUTTONDOWN或WM_MBUTTONUP消息,双击鼠标滚轮会发送WM_MBUTTONDBLCLK消息。另外,旋转滚轮会发送WM_MOUSEWHEEL消息。需要注意的是,WM_MOUSEWHEEL消息是发送给具有输入焦点的窗口,而不是光标位置下面的窗口。
- WM_MOUSEWHEEL消息的wParam参数的高位字表示本次滚轮旋转的距离,可能是正值或负值。正值表示滚轮向前旋转,远离用户;负值表示滚轮向后旋转,朝向用户。 WM_MOUSEWHEEL消息的wParam参数的低位字表示鼠标事件发生时其他鼠标按钮以及Ctrl和Shift键的状态标志,可用的标志和客户区鼠标消息的wParam参数相同。 可以使用以下代码获取wParam参数中的信息:
fwKeys = GET_KEYSTATE_WPARAM(wParam);
iDistance = GET_WHEEL_DELTA_WPARAM(wParam);
- WM_MOUSEWHEEL消息的lParam参数包含鼠标事件发生时光标热点的X坐标和Y坐标,相对于屏幕左上角。可以使用GET_X_LPARAM(lParam)和GET_Y_LPARAM(lParam)宏分别提取光标热点的X和Y坐标。
还有一个鼠标滚轮水平滚动的WM_MOUSEHWHEEL消息,加了一个H表示Horizontal,其消息参数和WM_MOUSEWHEEL消息的完全相同,在此不再赘述。处理完这两个消息以后应该返回0。
程序可以通过调用SystemParametersInfo函数获取一个WHEEL_DELTA值可以滚动的行数:
UINT uiScrollLines; // 在uiScrollLines中返回一个WHEEL_DELTA值所滚动的行数
SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &uiScrollLines, 0);
滚动行数的默认值为3,用户可以通过控制面板修改默认值。uiScrollLines可能返回0,在这种情况下不应该滚动。
常量WHEEL_DELTA在WinUser.h头文件中定义如下:
#define WHEEL_DELTA 120
就是说,滚动一行所需的增量为WHEEL_DELTA / uiScrollLines。
假设WM_MOUSEWHEEL消息中wParam参数的高位字值为192,正值表示滚轮向前旋转,远离用户,也就是向上滚动页面,此时应该滚动192/(WHEEL_DELTA/uiScrollLines),默认情况下就是192/40等于向上滚动4行。但是192/40还余32,为了提高用户体验,我们可以把这个32记录下来,加到下一次WM_MOUSEWHEEL消息中wParam参数的高位字上,当然也可以舍弃这个余下的32。
接下来,我们为SystemMetrics4程序添加鼠标滚轮垂直滚动条接口:
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
// …………
UINT uiScrollLines;
static int iDistancePerLine; // 滚动一行所需距离
static int iDistanceScroll; // 本次处理WM_MOUSEWHEEL消息需要滚动多少距离
switch (uMsg)
{
case WM_CREATE:
// …………
SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &uiScrollLines, 0);
if (uiScrollLines != 0)
iDistancePerLine = WHEEL_DELTA / uiScrollLines;
else
iDistancePerLine = 0;
return 0;
// …………
case WM_MOUSEWHEEL:
if (iDistancePerLine == 0)
return 0;
iDistanceScroll += GET_WHEEL_DELTA_WPARAM(wParam);
// GET_WHEEL_DELTA_WPARAM(wParam)是正数,滚轮向前旋转,远离用户,向上滚动
while (iDistanceScroll >= iDistancePerLine)
{
SendMessage(hwnd, WM_VSCROLL, SB_LINEUP, 0);
iDistanceScroll -= iDistancePerLine;
}
// GET_WHEEL_DELTA_WPARAM(wParam)是负数,滚轮向后旋转,朝向用户,向下滚动
while (iDistanceScroll <= -iDistancePerLine)
{
SendMessage(hwnd, WM_VSCROLL, SB_LINEDOWN, 0);
iDistanceScroll += iDistancePerLine;
}
return 0;
// …………
}
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
这里仅列出了增加的部分。在WM_CREATE消息中计算滚动一行所需的增量,在WM_MOUSEWHEEL消息中根据情况向上滚动或向下滚动。完整代码参见Chapter4\SystemMetrics5项目。
前面说过,滚动行数的默认值为3,用户可以通过控制面板修改其默认值。如果用户更改了系统参数,则系统会向所有顶级窗口广播WM_SETTINGCHANGE消息。如果希望把程序做得更友好,则应该处理WM_SETTINGCHANGE消息,在该消息中再次调用SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &uiScrollLines, 0);重新计算滚动一行所需的增量。
4.2.7 模拟鼠标消息
有两种方法可以很方便地实现模拟鼠标消息,一是使用SendMessage / PostMessage函数发送鼠标消息,二是使用mouse_event模拟鼠标事件。mouse_event函数合成鼠标移动和鼠标按钮单击事件,原型如下:
VOID mouse_event(
DWORD dwFlags, // 控制鼠标移动和按钮单击的标志位
DWORD dx, // 鼠标在X轴的绝对位置或者从上次鼠标事件产生以来移动的相对数量
DWORD dy, // 鼠标在Y轴的绝对位置或者从上次鼠标事件产生以来移动的相对数量
DWORD dwData, // 根据dwFlags参数的设置,具有不同含义
ULONG_PTR dwExtraInfo);// 与鼠标事件关联的附加值,可调用GetMessageExtraInfo以获取此额外信息
微软建议使用SendInput 函数代替mouse_event ,但是SendInput 函数用起来确实有点复杂。
参数dwFlags是控制鼠标移动和按钮单击的标志位,该参数可以是表4.17所示的值的组合。
表4.17
| 常量 | 含义 |
|---|---|
| MOUSEEVENTF_ABSOLUTE | 如果设置了该标志,dx和dy参数为鼠标移动的绝对位置,否则表示从上次鼠标事件产生以来移动的相对数量 |
| MOUSEEVENTF_MOVE | 鼠标移动 |
| MOUSEEVENTF_LEFTDOWN | 鼠标左键按下 |
| MOUSEEVENTF_LEFTUP | 鼠标左键抬起 |
| MOUSEEVENTF_MIDDLEDOWN | 鼠标中键按下 |
| MOUSEEVENTF_MIDDLEUP | 鼠标中键抬起 |
| MOUSEEVENTF_RIGHTDOWN | 鼠标右键按下 |
| MOUSEEVENTF_RIGHTUP | 鼠标右键抬起 |
| MOUSEEVENTF_XDOWN | X按钮按下,dwData参数指定按下哪个X按钮,XBUTTON1或XBUTTON2 |
| MOUSEEVENTF_XUP | X按钮抬起,dwData参数指定抬起哪个X按钮,XBUTTON1或XBUTTON2 |
| MOUSEEVENTF_WHEEL | 鼠标滚轮滚动,滚动量在dwData参数中指定 |
| MOUSEEVENTF_HWHEEL | 鼠标滚轮水平滚动,滚动量在dwData参数中指定 |
如果参数dwFlags指定了MOUSEEVENTF_ABSOLUTE标志,那么dx和dy参数为鼠标移动的绝对位置。dx和dy的值指定为0~65535,(0, 0)映射到屏幕的左上角,(65535, 65535)映射到屏幕的右下角。例如,如果希望把鼠标光标移动到离屏幕左上角向右200像素,向下100像素处,那么在1366 768分辨率的计算机上,应该这样调用mouse_event函数,我用按键1进行测试:
case WM_CHAR:
switch (wParam)
{
case '1':
mouse_event(MOUSEEVENTF_ABSOLUTE | MOUSEEVENTF_MOVE, 200 * 65535 / 1366,
100 * 65535 / 768, 0, 0);
break;
}
return 0;
如果参数dwFlags没有指定MOUSEEVENTF_ABSOLUTE标志,那么dx和dy表示相对于上次鼠标事件产生的位置的移动量,指定为正值表示鼠标向右(或下)移动,负值表示鼠标向左(或上)移动。但是,相对移动受指针移动速度和加速级别的设置影响,可以通过控制面板修改这些值,也可以通过指定SPI_SETMOUSESPEED或SPI_SETMOUSE参数调用SystemParametersInfo函数修改指针移动速度或加速级别。假设调用mouse_event(MOUSEEVENTF_MOVE, 10, 0, 0, 0);,不一定正好向右移动10像素。
189



被折叠的 条评论
为什么被折叠?



