当用户按下键盘上的一个键时,就会发生一系列事件。下表根据他们的发生顺序列出了这些事件:
表 所有元素的键盘事件(按顺序)
键盘处理永远不会像上面看到的这么简单。一些控件可能会挂起这些事件中的某些事件,从而可执行自己更特殊的键盘处理。最明显的例子是TextBox控件,它挂起了TextInput事件。对于一些按键,TextBox控件还挂起了KeyDown事件,如方向键。对于此类情形,通常仍可使用隧道路由事件(PreviewTextInput和PreviewKeyDown事件).
TextBox控件还添加了名为TextChanged的新事件。在按键导致文本框中的文本发生改变之后立即引发该事件。这时,在文本框中已经可以看到新的文本,所以阻止不需要的按键已为时太晚。
一、处理按键事件
理解键盘事件的最好方式是使用简单的示例程序,如下图所示。该例在一个文本框中监视所有可能的键盘事件,并在发生时给出报告。下图显示了文本框中输入大写A键时结果。
上面示例的完整代码如下所示:
<Window x:Class="KeyEvents.MainWindow" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="KeyPressEvents" Height="350" Width="468.421"> <Grid Margin="3"> <Grid.RowDefinitions> <RowDefinition Height="Auto"></RowDefinition> <RowDefinition Height="*"></RowDefinition> <RowDefinition Height="Auto"></RowDefinition> <RowDefinition Height="Auto"></RowDefinition> </Grid.RowDefinitions> <Grid.ColumnDefinitions> <ColumnDefinition Width="Auto"></ColumnDefinition> <ColumnDefinition Width="*"></ColumnDefinition> </Grid.ColumnDefinitions> <Label Grid.Row="0" Grid.Column="0">Type Here:</Label> <TextBox Grid.Row="0" Grid.Column="1" PreviewKeyDown="KeyEvent" KeyDown="KeyEvent" PreviewKeyUp="KeyEvent" KeyUp="KeyEvent" PreviewTextInput="TextInput" TextInput="TextInput"></TextBox> <ListBox Grid.ColumnSpan="2" Grid.Row="1" Grid.Column="0" Margin="5" Name="lstMessages"></ListBox> <CheckBox Name="chkHandle" Margin="5" Grid.ColumnSpan="2" Grid.Row="2">Ignore Keys Events</CheckBox> <Button Grid.Row="3" Margin="5" Padding="3" HorizontalAlignment="Right" Grid.ColumnSpan="2" Name="cmdClear" Click="cmdClear_Click">Clear list</Button> </Grid> </Window>
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Windows; using System.Windows.Controls; using System.Windows.Data; using System.Windows.Documents; using System.Windows.Input; using System.Windows.Media; using System.Windows.Media.Imaging; using System.Windows.Navigation; using System.Windows.Shapes; namespace KeyEvents { /// <summary> /// MainWindow.xaml 的交互逻辑 /// </summary> public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); } private void KeyEvent(object sender, KeyEventArgs e) { if ((bool)chkHandle.IsChecked && e.IsRepeat) return; string message = "Event:" + e.RoutedEvent + " Key:" + e.Key; this.lstMessages.Items.Add(message); } private void TextInput(object sender, TextCompositionEventArgs e) { string message = "Event:" + e.RoutedEvent + " Text:" + e.Text; this.lstMessages.Items.Add(message); } private void cmdClear_Click(object sender, RoutedEventArgs e) { this.lstMessages.Items.Clear(); } } }
该例演示了非常重要的一点。每次按下一个键时,都会触发PreviewKeyDown和PreviewKeyUp事件。但只有当字符可以“输入”到元素中时,才会触发TextInput事件。这一动作实际上可能涉及多个按键操作。从上图可知,为得到大写字母A,需要按下两个键。首先,按下Shift键,按着按下A键。因此,分别看到两个KeyDown和KeyUp事件,但只有一个TextInput事件。
PreviewKeyDown、KeyDown、PreviewKeyUp和KeyUp事件都通过KeyEventArgs对象提供了相同的信息。最重要的信息是Key属性,该属性返回一个System.Windows.Input.Key枚举值,该枚举值标识了按下或释放的键。下面是上图处理键盘事件的事件处理程序:
private void KeyEvent(object sender, KeyEventArgs e) { if ((bool)chkHandle.IsChecked && e.IsRepeat) return; string message = "Event:" + e.RoutedEvent + " Key:" + e.Key; this.lstMessages.Items.Add(message); }
Key值没有考虑任何其他键的状态。例如,当按下A键时不必关心当前是否按下了Shift键,不管是否按下了Shift键都会得到相同的Key值(Key.A).
这里还存在一个问题。根据Windows键盘的设置,持续按下一个键一段时间,会重复引发按键事件。例如,保持按下A键,显然会在文本框中输入一系列A字符。同样,按下Shift键一段时间也会得到多个按键和一系列KeyDown事件。按下Shift+A键进行测试的真实情况是,文本框实际上会为Shift键引发一系列KeyDown事件,然后为A键引发KeyDown事件,随后是TextInput事件(对于文本框,是TextChanged事件),最后是为Shift键和A键引发KeyUp事件。如果希望忽略这些重复的Shift键,可以通过检查KeyEventArgs.IsRepeat属性,确定按键是不是因为按住键导致的结果,如下所示:
if ((bool)chkHandle.IsChecked && e.IsRepeat) return;
KeyDown事件发生后,接着发生PreviewTextInput事件(因为TextBox控件挂起了TextInput事件,所以不会发生TextInput事件)。此时,文本尚未出现在控件中。
TextInput事件使用TextCompositionEventArgs对象提供代码。该对象包含Text属性,该属性提供了处理过的文本,它们是控件即将接受到得文本。下面的代码将这些文本添加到上图所示的列表中:
private void TextInput(object sender, TextCompositionEventArgs e) { string message = "Event:" + e.RoutedEvent + " Text:" + e.Text; this.lstMessages.Items.Add(message); }
理想情况下,可在控件(如TextBox控件)中使用PreviewTextInput事件执行验证工作。例如,如果构建只能输入数字的文本框,可确保当前按键不是字母,如果是就设置Handled标志。可惜,对于某些可能希望处理的键不会触发PreviewTextInput事件。例如,如果在文本框中按下了空格键,将直接绕过PreviewTextInput事件,这意味着还需要处理PreviewKeyDown事件。
但在PreviewKeyDown事件处理程序中编写出可靠的验证逻辑是比较困难的,因为在此只知道Key值,这是级别很低的信息。例如,Key枚举区分数字键盘和普通键盘字母以上的数字键。这意味着根据按下数字9的方式,可能得到的值Key.D9或Key.NumPad9.验证所有这些允许使用的键值至少可以说是非常枯燥的。
一种选择是使用KeyConverter类将Key值转换为更有用的字符串。例如,使用KeyConverter.ConverterToString()方法,Key.D9和Key.NumPad9都返回字符串“9”。如果只使用Key.ToString()方法,将得到不那么有用的枚举名称(D9或NumPad9):
KeyConverter converter=new KeyConverter(); string key=converter.ConverterToString(e.key);
然而,即使使用KeyConverter类也存在缺陷,因为对于不会产生文本输入的按键,会得到更长一点的文本(如Backspace).
最好同事处理PreviewTextInput事件(该事件负责大多数验证)和PreviewKeyDown事件,PreviewKeyDown用于那些在文本框中不会引发PreviewTextInput事件的按钮(例如空格键)。下面是完成这一工作的简单解决方案:
private void pnl_PreviewTextInput(object sender,TextCompositionEventArgs e) { short val; if(!Int16.TryParse(e.Text,out val)) { //Disallow non-numeric key presses. e.Handled=true; } } private void pnl_PreviewKeyDown(object sender,KeyEventArgs e) { if(e.Key==Key.Space) { // Disallow the space key,which doesn't raise a PreviewTextInput event. e.Handled=true; } }
可将这些事件处理程序关联到单个文本框,或在更高层次的容器(例如,包含几个只允许输入数字的文本框的StackPanel面板)中关联他们,这样做效率更高。
二、焦点
在Windows世界中,用户每次只能使用一个控件。当前接受用户按键的控件时具有焦点控件。有时,有焦点的控件的外观不同。例如,WPF按钮使用蓝色阴影显示它具有焦点。
为让控件能接受焦点,必须将Focusable属性设置为true,这是所有控件的默认值。
有趣的是,Focusable属性是在UIElement类中定义的,这意味着其他非控件元素也可以获得焦点。通常,对于非控件类,Focusable属性默认设置为false,但也可以设置为true。例如,使用布局容器(如StackPanel面板)测试这一点——当它获得焦点时,会在面板边缘的周围显示一条点划线边框。
为将焦点从一个元素移到另一个元素,用户可单击鼠标或使用Tab键和方向键。以前的开发框架强制编程人员确保Tab键以合理方式移动焦点(通常是从左项右,然后从上到下),并且确保在窗口第一次显示时正确的控件获得焦点。在WPF中,不必在完成这些额外工作,因为WPF使用层次结构的元素布局实现了Tab键切换焦点的顺序。本质上,按下Tab键会将焦点移到当前元素的第一个子元素,如果当前元素没有子元素,会将焦点移到同级的下一个子元素。例如,如果在具有两个StackPanel面板容器的窗口中使用Tab键转移焦点,焦点首先会通过第一个StackPanel面板中的所有控件,然后通过第二个StackPanel面板中的所有控件。
如果希望获得控制使用Tab键转移焦点顺序的功能,可按数字顺序设置每个控件的TabIndex属性。Tablndex属性为0的控件首先获得焦点,然后是次高的TabIndex值(例如首先是1,然后是2、3、4...等等)。如果多个元素具有相同的TabIndex值,WPF就使用自动Tab顺序,这意味着会跳过随后最靠近的元素。
TabIndex属性是在Control类中定义的,在该类中还定义了IsTabStop属性。可通过将IsTabStop属性设置为false来阻止控件被包含进Tab键焦点顺序。IsTabStop属性和Focusable属性之间的区别在于,如果控件的IsTabStop属性被设置为false,控件仍可通过其他方式获得焦点——通过编程(使用代码调用Focus()方法)或通过鼠标单击。
不可见或禁用的控件(“变灰的控件”)通常会忽略Tab键焦点顺序,并且不能被激活,不管TabIndex属性、IsTabStop属性以及Focusable属性如何设置。为了隐藏或禁用某个控件,可分别设置Visibility属性和IsEnabled属性。
三、获取键盘状态
当发生按键事件时,经常需要知道更多信息,而不仅要知道按下的是那个键。而且确定其他键是否同事被按下了也非常重要。这意味着可能需要检查其他键的状态,特别是Shift、Ctrl和Alt等修饰键。
对于键盘事件(PreviewKeyDown、KeyDown、PreviewKeyUp和KeyUp),获取这些信息比较容易。首先,KeyEventArgs对象包含KeyStates属性,该属性反映触发事件的键的属性。更有用的是,KeyboardDevice属性为键盘上的所有键提供了相同的信息。
自然,KeyboardDevice属性提供了KeyboardDevice类的一个实例。它的属性包含当前是哪个元素具有焦点(FocusedElement)以及当事件发生时按下了哪些修饰键。修饰键包括Shift、Ctrl和Alt键,并且可使用位逻辑来检查他们的状态。如下所示:
if((e.KeyboardDevice.Modifiers&ModifiersKeys.Control)==ModifierKeys.Control) { lblInfo.Text="You held the Control Key."; }
KeyboardDevice属性还提供了几个简便方法,这些方法在下表中列出。对于这些方法中的每个方法,需要传递一个Key枚举值。
表 KeyboardDevice属性提供的方法
当使用KeyEventArgs.KeyboardDevice属性时,代码获取虚拟键状态(virtual key state)。这意味着获取在事件发生时键盘的状态,这些状态和键盘的当前状态未必相同。例如,分析一下当用户输入速度超出代码执行速度时会发生什么情况?每次引发KeyPress事件时,都将访问触发事件的按键,而不是刚输入的字符。这几乎总是想得到的行为。
然而,没有限制在键盘事件中获取键的信息,也可以随时获取键盘状态信息。技巧是使用Keyboard类,该类和KeyboardDevice类非常类似,只是Keyboard类由静态成员构成。下面的例子使用Keyboard类检查左边Shift键的当前状态:
if(Keyboard.IsKeyDown(Key.LeftShift)) { lblInfo.Text="The left Shift is held down."; }