【WPF学习】第十六章 键盘输入

原文:【WPF学习】第十六章 键盘输入

  当用户按下键盘上的一个键时,就会发生一系列事件。下表根据他们的发生顺序列出了这些事件:

表 所有元素的键盘事件(按顺序)

【WPF学习】第十六章 键盘输入

 

   键盘处理永远不会像上面看到的这么简单。一些控件可能会挂起这些事件中的某些事件,从而可执行自己更特殊的键盘处理。最明显的例子是TextBox控件,它挂起了TextInput事件。对于一些按键,TextBox控件还挂起了KeyDown事件,如方向键。对于此类情形,通常仍可使用隧道路由事件(PreviewTextInput和PreviewKeyDown事件).

  TextBox控件还添加了名为TextChanged的新事件。在按键导致文本框中的文本发生改变之后立即引发该事件。这时,在文本框中已经可以看到新的文本,所以阻止不需要的按键已为时太晚。

一、处理按键事件

  理解键盘事件的最好方式是使用简单的示例程序,如下图所示。该例在一个文本框中监视所有可能的键盘事件,并在发生时给出报告。下图显示了文本框中输入大写A键时结果。

【WPF学习】第十六章 键盘输入

  上面示例的完整代码如下所示:

【WPF学习】第十六章 键盘输入
<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>
KeyEvents.XAML
【WPF学习】第十六章 键盘输入
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();
        }
    }
}
KeyEvents.cs

   该例演示了非常重要的一点。每次按下一个键时,都会触发PreviewKeyDown和PreviewKeyUp事件。但只有当字符可以“输入”到元素中时,才会触发TextInput事件。这一动作实际上可能涉及多个按键操作。从上图可知,为得到大写字母A,需要按下两个键。首先,按下Shift键,按着按下A键。因此,分别看到两个KeyDown和KeyUp事件,但只有一个TextInput事件。

  PreviewKeyDown、KeyDown、PreviewKeyUp和KeyUp事件都通过KeyEventArgs对象提供了相同的信息。最重要的信息是Key属性,该属性返回一个System.Windows.Input.Key枚举值,该枚举值标识了按下或释放的键。下面是上图处理键盘事件的事件处理程序:

【WPF学习】第十六章 键盘输入
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);
        }
【WPF学习】第十六章 键盘输入

  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事件的按钮(例如空格键)。下面是完成这一工作的简单解决方案:

【WPF学习】第十六章 键盘输入
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;
    }
}
【WPF学习】第十六章 键盘输入

  可将这些事件处理程序关联到单个文本框,或在更高层次的容器(例如,包含几个只允许输入数字的文本框的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属性提供的方法

【WPF学习】第十六章 键盘输入

 

   当使用KeyEventArgs.KeyboardDevice属性时,代码获取虚拟键状态(virtual key state)。这意味着获取在事件发生时键盘的状态,这些状态和键盘的当前状态未必相同。例如,分析一下当用户输入速度超出代码执行速度时会发生什么情况?每次引发KeyPress事件时,都将访问触发事件的按键,而不是刚输入的字符。这几乎总是想得到的行为。

  然而,没有限制在键盘事件中获取键的信息,也可以随时获取键盘状态信息。技巧是使用Keyboard类,该类和KeyboardDevice类非常类似,只是Keyboard类由静态成员构成。下面的例子使用Keyboard类检查左边Shift键的当前状态:

if(Keyboard.IsKeyDown(Key.LeftShift))
{
    lblInfo.Text="The  left Shift is held down.";
}

 

【WPF学习】第十六章 键盘输入

上一篇:2020年2月9日——常用的Windows快捷键


下一篇:NScript - 基于 .Net 框架的 Windows 脚本工具集;