WM_CHAR消息
当 TranslateMessage 函数翻译WM_KEYDOWN消息时,使用键盘焦点发布到窗口。 WM_CHAR消息包含按下的键的字符代码。
#define WM_CHAR 0x0102
-
wParam
-
键的字符代码。
-
lParam
-
重复计数、扫描代码、扩展键标志、上下文代码、以前的键状态标志和转换状态标志,如下表所示。
Bits 含义 0-15 当前消息的重复计数。 该值是由于用户按住键而自动重复击键的次数。 如果击键的保持时间足够长,则发送多个消息。 但是,重复计数不是累积的。 16-23 扫描代码。 该值取决于 OEM。 24 指示键是否为扩展键,例如显示在增强型 101 键或 102 键键盘上的右侧 Alt 和 Ctrl 键。 如果是扩展键,则值为 1;否则为 0。 25-28 保留;请勿使用。 29 上下文代码。 如果在按住 ALT 键的同时按该键,则值为 1;否则值为 0。 30 上一个键状态。 如果在发送消息之前键处于按下状态,则值为 1;如果键处于未按下状态,则值为 0。 31 转换状态。 如果释放了键,则值为 1;如果按下了键,则值为 0。 有关详细信息,请参阅 击键消息标志。
如果应用程序处理此消息,则应返回零。
LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
switch (message)
{
// ...
case WM_CHAR:
OnKeyPress(wParam);
break;
default:
return DefWindowProc(hwnd, message, wParam, lParam);
}
return 0;
}
GitHub 上的 Windows 经典示例中的例子。
如果使用 RegisterClass 函数的 Unicode 版本注册窗口类,则WM_CHAR消息在其 wParam 中使用 UTF-16 (16 位 Unicode 转换格式) 代码单元。 否则,系统会在当前进程代码页中提供字符,可在 Windows 版本 1903 (2019 年 5 月更新) 及更新版本中将其设置为 UTF-8。 有关详细信息,请参阅 注册窗口类 和 在 Windows 应用中使用 UTF-8 代码页。
从 Windows Vista 开始, WM_CHAR 消息可以将 UTF-16 代理项对 发送到 Unicode 窗口。 如有必要,请使用 IS_HIGH_SURROGATE、 IS_LOW_SURROGATE和 IS_SURROGATE_PAIR 宏来检测此类情况。
按下的键和生成的字符消息之间不一定有一对一的对应关系,因此 lParam 参数的高阶字中的信息通常对应用程序没有用。 高序字中的信息仅适用于发布 WM_CHAR 消息之前的最新 WM_KEYDOWN 消息。
对于增强型 101 键和 102 键键盘,扩展键是键盘main部分的右 Alt 键和右侧 CTRL 键;数字小键盘左侧群集中的 INS、DEL、HOME、END、PAGE UP、PAGE Down 和箭头键;数字小键盘中的除号 (/) 和 ENTER 键。 其他一些键盘可能支持 lParam 参数中的扩展键位。
WM_UNICHAR消息与 WM_CHAR 相同,只不过它使用 UTF-32。 它旨在将 Unicode 字符发送或发布到 ANSI 窗口,并且可以处理 Unicode 补充平面字符。
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
标头 |
|