vkKeyScanA 函数 (winuser.h)

  • 项目

[此函数已被 VkKeyScanEx 函数取代。 但是，如果不需要指定键盘布局，仍然可以使用 VkKeyScan。]

将字符转换为当前键盘的相应虚拟键代码和偏移状态。

语法

SHORT VkKeyScanA(
  [in] CHAR ch
);

参数

[in] ch

类型： TCHAR

要转换为虚拟键代码的字符。

返回值

类型： SHORT

如果函数成功，则返回值的低序字节包含虚拟键代码，高序字节包含 shift 状态，可以是以下标志位的组合。

返回值 说明
1
 按下任一 SHIFT 键。
2
 按下任一 Ctrl 键。
4
 按下任一 Alt 键。
8
 按下了 Hankaku 键
16
 键盘布局驱动程序) 定义的保留 (。
32
 键盘布局驱动程序) 定义的保留 (。
 

如果函数找不到转换为传递的字符代码的键，则低序字节和高阶字节都包含 –1。

注解

对于使用右 Alt 键作为移位键的键盘布局 (例如法语键盘布局) ，移位状态由值 6 表示，因为右侧 Alt 键在内部转换为 CTRL+Alt。

将忽略通过VK_DIVIDE) VK_NUMPAD0 的数字键盘 ( 转换。 此函数仅用于将字符转换为来自main键盘部分的击键。 例如，字符“7”将转换为VK_7，而不是VK_NUMPAD7。

VkKeyScan 由使用 WM_KEYUP 和 WM_KEYDOWN 消息发送字符的应用程序使用。

注意

winuser.h 标头将 VkKeyScan 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅