getAsyncKeyState 函数 (winuser.h)
确定调用函数时键是向上还是向下，以及上次调用 GetAsyncKeyState 后是否按下了该键。
语法
SHORT GetAsyncKeyState(
[in] int vKey
);
参数
[in] vKey
类型： int
虚拟密钥代码。 有关详细信息，请参阅 虚拟密钥代码。
可以使用左右区分常量来指定某些键。 有关详细信息，请参阅备注部分。
返回值
类型： SHORT
如果函数成功，则返回值指定自上次调用 GetAsyncKeyState 以来是否按下了键，以及键当前是打开还是关闭。 如果设置了最有效位，则键关闭，如果设置了最小有效位，则上一次调用 GetAsyncKeyState 后按下了键。 但是，不应依赖于此最后一种行为;有关详细信息，请参阅备注。
对于以下情况，返回值为零：
- 当前桌面不是活动桌面
- 前台线程属于另一个进程，桌面不允许挂钩或日志记录。
注解
GetAsyncKeyState 函数适用于鼠标按钮。 但是，它会检查物理鼠标按钮的状态，而不是物理按钮映射到的逻辑鼠标按钮。 例如，调用 GetAsyncKeyState (VK_LBUTTON) 始终返回左物理鼠标按钮的状态，无论它是映射到左逻辑鼠标按钮还是右逻辑鼠标按钮。 可以通过调用 GetSystemMetrics(SM_SWAPBUTTON)来确定系统的物理鼠标按钮到逻辑鼠标按钮的当前映射。
如果已交换鼠标按钮，则返回 TRUE。
尽管返回值的最小有效位指示自上次查询以来是否已按下键，但由于 Windows 的抢占性多任务性质，另一个应用程序可以调用 GetAsyncKeyState 并接收“最近按下的”位，而不是应用程序。 严格保留返回值中最小有效位的行为，以便与 16 位 Windows 应用程序兼容， (这些应用程序是非抢占) 且不应依赖的。
可以使用虚拟键代码常量 VK_SHIFT、 VK_CONTROL和 VK_MENU 作为 vKey 参数的值。 这会提供 SHIFT、Ctrl 或 ALT 键的状态，而不区分左键和右键。
可以使用以下虚拟键代码常量作为 vKey 的值来区分这些键的左实例和右实例。
| 代码 | 含义 |
|---|---|
| VK_LSHIFT | 左移键。 |
| VK_RSHIFT | 右移键。 |
| VK_LCONTROL | 左控制键。 |
| VK_RCONTROL | 右侧控制键。 |
| VK_LMENU | 左侧菜单键。 |
| VK_RMENU | 右侧菜单键。 |
这些左右区分常量仅在调用 GetKeyboardState、SetKeyboardState、GetAsyncKeyState、GetKeyState 和 MapVirtualKey 函数时可用。
示例
while (GetMessage(&msg, nullptr, 0, 0))
{
if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
switch (msg.message)
{
case WM_KEYDOWN:
if ((GetAsyncKeyState(VK_ESCAPE) & 0x01) && bRunning)
{
Stop();
}
break;
}
}
GitHub 上的 Windows 经典示例中的例子。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winuser.h (包括 Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |