键盘输入工作原理

项目
10/23/2023

Windows 窗体通过引发键盘事件来处理键盘输入，以响应 Windows 消息。大多数 Windows 窗体应用程序都通过处理键盘事件来以独占方式处理键盘输入。但是，必须了解键盘消息的工作方式，才能实现更高级的键盘输入方案（如在按键到达控件之前截获它们）。本主题描述 Windows 窗体能够识别的按键数据的类型，并概述键盘消息的传送方式。有关键盘事件的信息，请参阅使用键盘事件。

按键的类型

Windows 窗体将键盘输入标识为由按位 Keys 枚举表示的虚拟键代码。使用 Keys 枚举，可以组合一系列按键以生成单个值。这些值与 WM_KEYDOWN 和 WM_SYSKEYDOWN Windows 消息所附带的值相对应。可以通过处理 KeyDown 或 KeyUp 事件来检测大多数物理按键。字符键是 Keys 枚举的子集，它们与 WM_CHAR 和 WM_SYSCHAR Windows 消息所附带的值相对应。如果通过组合按键得到一个字符，则可以通过处理 KeyPress 事件来检测该字符。或者，可以使用由 Visual Basic 编程接口公开的 Keyboard 来发现哪些键已按下并发送这些键。有关详细信息，请参阅访问键盘。

键盘事件的顺序

正如上面列出的那样，在一个控件上可能出现三个与键盘相关的事件。以下顺序是发生这些事件的常规顺序：

用户按“a”键，该键将被预处理和调度，并且会发生 KeyDown 事件。
用户按住“a”键，该键将被预处理和调度，并且会发生 KeyPress 事件。

当用户按住某个键时，此事件会发生多次。
用户松开“a”键，该键将被预处理和调度，并且会发生 KeyUp 事件。

键的预处理

与其他消息一样，键盘消息也是在窗体或控件的 WndProc 方法中处理的。但是，在处理键盘消息之前，PreProcessMessage 方法会调用一个或多个方法，这些方法可被重写以处理特殊的字符键和物理按键。可以重写这些方法，以便在控件处理消息之前检测并筛选某些按键。下表按照方法出现的顺序列出了正在执行的操作以及所出现的相关方法。

KeyDown 事件的预处理

操作	相关方法	说明
检查命令键（如快捷键或菜单快捷键）。	ProcessCmdKey	此方法处理命令键，命令键的优先级高于常规键。如果此方法返回 `true`，则不调度键消息，而且不发生键事件。如果它返回 `false`，则调用 IsInputKey。
检查该键是否为需要预处理的特殊键，或者是否为应引发 KeyDown 事件并且被调度到某个控件的普通字符键。	IsInputKey	如果此方法返回 `true`，则表示该控件为常规字符，并且会引发 KeyDown 事件。如果返回 `false`，则调用 ProcessDialogKey。注意：若要确保控件获取某个键或组合键，可以处理 PreviewKeyDown 事件，并针对所需的键或组合键将 PreviewKeyDownEventArgs 的 IsInputKey 设置为 `true`。
检查该键是否为导航键（Esc、Tab、回车键或箭头键）。	ProcessDialogKey	此方法处理在控件内实现特殊功能（如在控件与其父级之间切换焦点）的物理按键。如果中间控件不处理该键，则会调用父控件的 ProcessDialogKey，直至层次结构中的最顶端控件。如果此方法返回 `true`，则完成预处理，而且不生成按键事件。如果它返回 `false`，则会发生 KeyDown 事件。

KeyPress 事件的预处理

操作	相关方法	说明
检查该键是否为控件应当处理的普通字符	IsInputChar	如果该字符是普通字符，则此方法返回 `true`，并且引发 KeyPress 事件，而且不再进行预处理。否则，将调用 ProcessDialogChar。
检查该字符是否为助记键（如按钮上的“确定(&O)”）	ProcessDialogChar	与 ProcessDialogKey 类似，将调用此方法，直至控件层次结构的顶端。如果控件是容器控件，此方法会通过调用控件及其子控件的 ProcessMnemonic 来检查助记键。如果 ProcessDialogChar 返回 `true`，则不会发生 KeyPress 事件。

处理键盘消息

键盘消息在到达窗体或控件的 WndProc 方法之后，它们会由一组可重写的方法来处理。其中的每种方法都返回一个 Boolean 值，该值指定控件是否已处理和使用了键盘消息。如果其中的某种方法返回 true，则键盘消息被视为已处理，而且它不传递到控件的基控件或父控件进行进一步处理。否则，消息停留在消息队列中，而且可能会在控件的基控件或父控件的其他方法中进行处理。下表显示用来处理键盘消息的方法。

方法	说明
ProcessKeyMessage	此方法处理由控件的 WndProc 方法接收的所有键盘消息。
ProcessKeyPreview	此方法将键盘消息发送到控件的父控件。如果 ProcessKeyPreview 返回 `true`，则不生成键事件，否则将调用 ProcessKeyEventArgs。
ProcessKeyEventArgs	此方法会根据需要引发 KeyDown、KeyPress 和 KeyUp 事件。

重写键盘方法

在预处理和处理键盘消息时，可以使用许多方法进行重写；但是，这些方法有好有坏。下表显示可能需要完成的任务以及重写键盘方法的最佳方式。有关重写方法的详细信息，请参阅重写派生类中的属性和方法。

任务	方法
截获导航键并引发 KeyDown 事件。例如，希望在文本框中处理 Tab 键和回车键。	重写 IsInputKey。注意：还可以处理 PreviewKeyDown 事件，并针对所需的键或组合键将 PreviewKeyDownEventArgs 的 IsInputKey 设置为 `true`。
在控件上执行特殊的输入或导航处理。例如，你可能希望在列表控件中使用箭头键更改选定项。	重写 ProcessDialogKey
截获导航键并引发 KeyPress 事件。例如，你希望在数字调整框控件中，多次按箭头键来加快项的调整进度。	重写 IsInputChar。
在 KeyPress 事件期间执行特殊的输入或导航处理。例如，在列表控件中，按住“r”键将跳到以字母 r 开头的项并在这些项间切换。	重写 ProcessDialogChar
执行自定义的助记键处理；例如，你希望处理所有者描述的、包含在工具栏中的按钮上的助记键。	重写 ProcessMnemonic。

通过