Windows 窗体中的用户输入.docx
《Windows 窗体中的用户输入.docx》由会员分享，可在线阅读，更多相关《Windows 窗体中的用户输入.docx（62页珍藏版）》请在冰豆网上搜索。
Windows窗体中的用户输入
Windows窗体中的用户输入
.NETFramework4.5
其他版本
此主题尚未评级 - 评价此主题
Windows窗体包括一种用户输入模型，该模型基于在处理相关的Windows消息时所引发的事件。
本节中的主题提供了有关鼠标和键盘用户输入的信息，其中包括演示如何执行特定任务的代码示例。
本节内容
Windows窗体应用程序中的用户输入
提供处理Windows消息的用户输入事件和方法的概述。
Windows窗体应用程序中的键盘输入
提供有关键盘消息处理、不同类型的键和键盘事件的信息。
Windows窗体应用程序中的鼠标输入
提供有关鼠标事件和其他鼠标相关功能（包括鼠标光标和鼠标捕获）的信息。
如何：
在代码中模拟鼠标和键盘事件
演示通过编程模拟鼠标和键盘输入的几种不同方式。
如何：
在Windows窗体控件中处理用户输入事件
显示处理大多数用户输入事件的代码示例，并报告有关每个事件的信息。
Windows窗体中的用户输入验证
描述用于验证Windows窗体应用程序中的用户输入的方法。
相关章节
Topic
Location
在Windows窗体中创建事件处理程序
.NETFrameworkSDK托管客户端
在Windows窗体中创建事件处理程序
.NETFrameworkSDK托管客户端
在Windows窗体中创建事件处理程序
.NETFrameworkSDK托管客户端
在Windows窗体中创建事件处理程序
dv_fxmancli
在Windows窗体中创建事件处理程序
dv_fxmancli
社区附加资源
Windows窗体应用程序中的用户输入
.NETFramework4.5
其他版本
在Windows窗体中，用户输入以Windows消息的形式发送到应用程序。
一系列可重写的方法在应用程序、窗体和控件级处理这些消息。
当这些方法接收到鼠标和键盘消息时，将引发相应的事件，可以处理这些事件来获取关于鼠标或键盘输入的信息。
在许多情况下，Windows窗体应用程序可以仅仅通过处理这些事件来处理所有用户输入。
在其他情况下，应用程序可能需要重写处理消息的某个方法，以便在特定消息被应用程序、窗体或控件接收前截获它。
鼠标和键盘事件
所有Windows窗体控件都继承一组与鼠标和键盘输入有关的事件。
例如，控件可以处理 KeyPress 事件来确定所按键的字符代码，也可以处理 MouseClick 事件来确定鼠标单击的位置。
有关鼠标和键盘事件的更多信息，请参见 使用键盘事件 和 Windows窗体中的鼠标事件。
处理用户输入消息的方法
窗体和控件可以访问 IMessageFilter 界面和一组可重写的方法，这些方法处理消息队列中不同位置的Windows消息。
这些方法都有 Message 参数，该参数封装Windows消息的低级别详细信息。
可以实现或重写这些方法，以检查消息，然后或者使用该消息，或者将消息传递到消息队列中的下一个使用者。
下表列出了处理Windows窗体中的所有Windows消息的方法。
方法
注释
PreFilterMessage
此方法在应用程序级截获排队的（也称为已发送的）Windows消息。
PreProcessMessage
此方法在Windows消息处理前在窗体和控件级截获它们。
WndProc
此方法在窗体和控件级处理Windows消息。
DefWndProc
此方法在窗体和控件级执行Windows消息的默认处理。
这提供了窗口的最小功能。
OnNotifyMessage
此方法在消息处理后在窗体和控件级截获它们。
若要调用此方法，必须设置 EnableNotifyMessage 样式位。
键盘和鼠标消息也可以被另外一组可重写的、特定于这些消息类型的方法处理。
有关更多信息，请参见 键盘输入工作原理 和 Windows窗体中鼠标输入的工作原理。
Windows窗体应用程序中的键盘输入
.NETFramework4.5
Windows窗体包括允许您对特定按键作出响应的标准键盘事件，还提供了在应用程序、窗体和控件级别截获、修改和使用按键的方式。
本节内容
键盘输入工作原理
描述键盘消息如何处理和转换为键盘事件。
使用键盘事件
提供有关键盘事件类型的信息，还提供键盘事件处理程序所接收的信息。
如何：
修改标准控件中的键盘输入
提供用于显示在键值到达控件之前如何修改键值的代码示例。
如何：
确定所按下的修改键
演示如何确定除了另一个键以外是否还按了Shift、Alt或Ctrl键。
如何：
在窗体级别处理键盘输入
提供用于显示如何在键到达控件之前截获键的代码示例。
键盘输入工作原理
.NETFramework4.5
其他版本
此主题尚未评级 - 评价此主题
Windows窗体通过引发键盘事件来处理键盘输入以响应Windows消息。
大多数Windows窗体应用程序都通过处理键盘事件来以独占方式处理键盘输入。
但是，必须了解键盘消息的工作方式，才能实现更高级的键盘输入方案（如在按键到达控件之前截获它们）。
本主题描述Windows窗体能够识别的按键数据的类型，并概述键盘消息的传送方式。
有关键盘事件的信息，请参见 使用键盘事件。
按键的类型
Windows窗体将键盘输入标识为由按位 Keys 枚举表示的虚拟键代码。
使用 Keys 枚举，可以综合一系列按键以生成单个值。
这些值与WM_KEYDOWN和WM_SYSKEYDOWNWindows消息所伴随的值相对应。
可通过处理 KeyDown 或 KeyUp 事件来检测大多数物理按键操作。
字符键是 Keys 枚举的子集，它们与WM_CHAR和WM_SYSCHARWindows消息所伴随的值相对应。
如果通过组合按键得到一个字符，则可以通过处理KeyPress 事件来检测该字符。
或者，可以使用由VisualBasic编程接口公开的 Keyboard 来发现已按下的键并发送它们。
有关更多信息，请参见 访问键盘（VisualBasic）。
键盘事件的顺序
正如上面列出的那样，在一个控件上可能出现三个与键盘相关的事件。
以下顺序是发生这些事件的常规顺序：
1.用户按“a”键，该键将被预处理和调度，而且会发生 KeyDown 事件。
2.用户按住“a”键，该键将被预处理和调度，而且会发生 KeyPress 事件。
在用户按住某个键时，此事件会发生多次。
3.用户松开“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 事件。
重写键盘方法
在预处理和处理键盘消息时，可以使用许多方法进行重写；但是，这些方法有好有坏。
下表显示可能需要完成的任务以及重写键盘方法的最佳方式。
有关重写方法的更多信息，请参见OverridingPropertiesandMethods。
任务
方法
截获导航键并引发 KeyDown 事件。
例如，您希望在文本框中处理Tab和回车键。
重写 IsInputKey。
说明
此外，也可以处理 PreviewKeyDown 事件，并针对所需的一个或多个键，将 PreviewKeyDownEventArgs的 IsInputKey 设置为 true。
在控件上执行特殊的输入或导航处理。
例如，您可能希望在列表控件中使用箭头键更改选定项。
重写 ProcessDialogKey
截获导航键并引发 KeyPress 事件。
例如，您可能希望在数字显示框控件中，多次按箭头键来加快数值的设定速度。
重写 IsInputChar。
在发生 KeyPress 事件期间执行特殊的输入或导航处理。
例如，在列表控件中，按住“r”键将跳到以字母r开头的项并在这些项间切换。
重写 ProcessDialogChar
执行自定义的助记键处理；例如，您希望处理所有者描述的、包含在工具栏中的按钮上的助记键。
重写 ProcessMnemonic。
使用键盘事件
.NETFramework4.5
其他版本
此主题尚未评级 - 评价此主题
大多数Windows窗体程序都通过处理键盘事件来处理键盘输入。
本主题提供键盘事件的概述，其中包括关于何时使用每个事件以及提供给每个事件的数据的详细信息。
键盘事件
当用户按键盘键时，Windows窗体提供两个事件，而当用户松开键盘键时，Windows窗体提供一个事件。
∙KeyDown 事件发生一次
∙KeyPress 事件，当用户按住同一个键时，该事件可以发生多次。
∙当用户松开键时，KeyUp 事件发生一次。
当用户按键时，Windows窗体根据键盘消息指定的是字符键还是物理键来确定要引发的事件。
有关字符键和物理键的更多信息，请参见 键盘输入工作原理。
下表对这三个键盘事件进行了说明。
键盘事件
说明
结果
KeyDown
当用户按物理键时将引发此事件。
KeyDown 的处理程序接收：
∙一个 KeyEventArgs 参数，它提供 KeyCode 属性（它指定一个物理键盘按钮）。
∙Modifiers 属性（Shift、Ctrl或Alt）。
∙KeyData 属性（它组合键代码和修改键）。
KeyEventArgs 参数还提供：
oHandled 属性，可以设置该属性以防止基础控件接收键。
oSuppressKeyPress 属性，它可以用来抑制该键击的 KeyPress 和 KeyUp 事件。
KeyPress
当所按的键产生字符时将引发此事件。
例如，当用户按Shift和小写的“a”键时，将产生大写字母“A”字符。
KeyPress 在 KeyDown 之后引发。
∙KeyPress 的处理程序接收：
∙一个 KeyPressEventArgs 参数，它包含所按键的字符代码。
此字符代码对于字符键和修改键的每个组合都是唯一的。
例如，“A”键将生成：
o字符代码65（如果与Shift键一起按下）
o或CapsLock键97（如果只按下它一个键），
o和1（如果它与Ctrl键一起按下）。
KeyUp
当用户松开物理键时将引发此事件。
KeyUp 的处理程序接收：
∙KeyEventArgs 参数：
o它提供 KeyCode 属性（指定一个物理键盘按钮）。
oModifiers 属性（Shift、Ctrl或Alt）。
oKeyData 属性（它组合键代码和修改键）。
请参见
如何：
修改标准控件中的键盘输入
.NETFramework4.5
其他版本
此主题尚未评级 - 评价此主题
Windows窗体提供了使用和修改键盘输入的功能。
使用键是指在方法或事件处理程序中对键进行处理，以便消息队列中随后的其他方法和事件不会收到键值。
修改键是指修改键值，以便消息队列中随后的方法和事件处理程序收到另一个键值。
本主题显示如何完成这些任务。
使用键
∙在 KeyPress 事件处理程序中，将 KeyPressEventArgs 类的 Handled 属性设置为 true。
-或-
在 KeyDown 事件处理程序中，将 KeyEventArgs 类的 Handled 属性设置为 true。
说明
如果在 KeyDown 事件处理程序中设置 Handled 属性，将不会阻止对当前按键引发 KeyPress 和 KeyUp 事件。
请将 SuppressKeyPress 属性用于此目的。
下面的示例摘录自 switch 语句，该语句检查 KeyPress 事件处理程序所收到的 KeyPressEventArgs 的 KeyChar 属性。
此代码使用“A”和“a”字符键。
C#
VB
'Consume'A'and'a'.
CaseChrW（65）,ChrW（97）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'consumed."））
e.Handled=True
修改标准字符键
∙在 KeyPress 事件处理程序中，将 KeyPressEventArgs 类的 KeyChar 属性设置为新字符键的值。
下面的示例摘录自 switch 语句，该语句将“B”修改为“A”，并将“b”修改为“a”。
注意，KeyPressEventArgs 的 Handled 属性设置为 false，以便将新的键值传播到消息队列中的其他方法和事件。
C#
VB
'Modify'B'to'A'andforwardthekey.
CaseChrW（66）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'replacedby'A'."））
e.KeyChar=ChrW（65）
e.Handled=False
'Modify'b'to'a'andforwardthekey.
CaseChrW（98）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'replacedby'a'."））
e.KeyChar=ChrW（97）
e.Handled=False
修改非字符键
∙重写用于处理Windows消息的 Control 方法，并检测WM_KEYDOWN或WM_SYSKEYDOWN消息，然后将 Message 参数的 WParam 属性设置为表示新的非字符键的 Keys 值。
下面的代码示例演示如何重写控件的 PreProcessMessage 方法，以检测键F1到F9，并将任何F3键修改为按F1键。
有关可以重写以截获键盘消息的 Control 方法的更多信息，请参见 Windows窗体应用程序中的用户输入 和 键盘输入工作原理。
C#
VB
'DetectF1throughF9duringpreprocessingandmodifyF3.
PublicOverridesFunctionPreProcessMessage（ByRefmAsMessage）_
AsBoolean
Ifm.Msg=WM_KEYDOWNThen
DimkeyCodeAsKeys=CType（m.WParam,Keys）AndKeys.KeyCode
'DetectF1throughF9.
SelectCasekeyCode
CaseKeys.F1,Keys.F2,Keys.F3,Keys.F4,Keys.F5,_
Keys.F6,Keys.F7,Keys.F8,Keys.F9
MessageBox.Show（（"Control.PreProcessMessage:
'"+_
keyCode.ToString（）+"'pressed."））
'ReplaceF3withF1,sothatProcessKeyMessagewill
'receiveF1insteadofF3.
IfkeyCode=Keys.F3Then
m.WParam=CType（Keys.F1,IntPtr）
MessageBox.Show（（"Control.PreProcessMessage:
'"+_
keyCode.ToString（）+"'replacedbyF1."））
EndIf
EndSelect
EndIf
'Sendallothermessagestothebasemethod.
ReturnMyBase.PreProcessMessage（m）
EndFunction
示例
下面的代码示例是上述各节中的全部代码示例应用程序。
应用程序使用从 TextBox 类派生的自定义控件来使用和修改键盘输入。
C#
VB
ImportsSystem
ImportsSystem.Drawing
ImportsSystem.Security
ImportsSystem.Security.Permissions
ImportsSystem.Windows.Forms
NamespaceKeyboardInput
="FullTrust"）>_
ClassForm1
InheritsForm
'ThefollowingWindowsmessagevalueisdefinedinWinuser.h.
PrivateWM_KEYDOWNAsInteger=&H100
PrivateWithEventsCustomTextBox1AsNewCustomTextBox（）
_
PublicSharedSubMain（）
Application.EnableVisualStyles（）
Application.Run（NewForm1（））
EndSub
PublicSubNew（）
Me.AutoSize=True
Me.Controls.Add（CustomTextBox1）
EndSub
'Consumeandmodifyseveralcharacterkeys.
SubCustomTextBox1_KeyPress（ByValsenderAsObject,_
ByValeAsKeyPressEventArgs）HandlesCustomTextBox1.KeyPress
SelectCasee.KeyChar
'Consume'A'and'a'.
CaseChrW（65）,ChrW（97）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'consumed."））
e.Handled=True
'Modify'B'to'A'andforwardthekey.
CaseChrW（66）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'replacedby'A'."））
e.KeyChar=ChrW（65）
e.Handled=False
'Modify'b'to'a'andforwardthekey.
CaseChrW（98）
MessageBox.Show（（"Control.KeyPress:
'"+_
e.KeyChar.ToString（）+"'replacedby'a'.
升级会员 