當用戶按下鍵盤上的一個鍵時,就會發生一系列事件,下表根據他們的發生順序列出了這些事件:
表 所有元素的鍵盤事件(按順序)

鍵盤處理永遠不會像上面看到的這么簡單,一些控制元件可能會掛起這些事件中的某些事件,從而可執行自己更特殊的鍵盤處理,最明顯的例子是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>KeyEvents.XAML
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列舉值,該列舉值標識了按下或釋放的鍵,下面是上圖處理鍵盤事件的事件處理程式:
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."; }
轉載請註明出處,本文鏈接:https://www.uj5u.com/net/8201.html
標籤:WPF
下一篇:【WPF學習】第十七章 滑鼠輸入
