當(dāng)用戶按下鍵盤上的一個(gè)鍵時(shí),就會(huì)發(fā)生一系列事件。下表根據(jù)他們的發(fā)生順序列出了這些事件: 表 所有元素的鍵盤事件(按順序) 鍵盤處理永遠(yuǎn)不會(huì)像上面看到的這么簡(jiǎn)單。一些控件可能會(huì)掛起這些事件中的某些事件,從而可執(zhí)行自己更特殊的鍵盤處理。最明顯的例子是TextBox控件,它掛起了TextInput事件。對(duì)于一些按鍵,TextBox控件還掛起了KeyDown事件,如方向鍵。對(duì)于此類情形,通常仍可使用隧道路由事件(PreviewTextInput和PreviewKeyDown事件). TextBox控件還添加了名為TextChanged的新事件。在按鍵導(dǎo)致文本框中的文本發(fā)生改變之后立即引發(fā)該事件。這時(shí),在文本框中已經(jīng)可以看到新的文本,所以阻止不需要的按鍵已為時(shí)太晚。 一、處理按鍵事件 理解鍵盤事件的最好方式是使用簡(jiǎn)單的示例程序,如下圖所示。該例在一個(gè)文本框中監(jiān)視所有可能的鍵盤事件,并在發(fā)生時(shí)給出報(bào)告。下圖顯示了文本框中輸入大寫A鍵時(shí)結(jié)果。 上面示例的完整代碼如下所示: <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(); } } } 該例演示了非常重要的一點(diǎn)。每次按下一個(gè)鍵時(shí),都會(huì)觸發(fā)PreviewKeyDown和PreviewKeyUp事件。但只有當(dāng)字符可以“輸入”到元素中時(shí),才會(huì)觸發(fā)TextInput事件。這一動(dòng)作實(shí)際上可能涉及多個(gè)按鍵操作。從上圖可知,為得到大寫字母A,需要按下兩個(gè)鍵。首先,按下Shift鍵,按著按下A鍵。因此,分別看到兩個(gè)KeyDown和KeyUp事件,但只有一個(gè)TextInput事件。 PreviewKeyDown、KeyDown、PreviewKeyUp和KeyUp事件都通過KeyEventArgs對(duì)象提供了相同的信息。最重要的信息是Key屬性,該屬性返回一個(gè)System.Windows.Input.Key枚舉值,該枚舉值標(biāo)識(shí)了按下或釋放的鍵。下面是上圖處理鍵盤事件的事件處理程序: 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值沒有考慮任何其他鍵的狀態(tài)。例如,當(dāng)按下A鍵時(shí)不必關(guān)心當(dāng)前是否按下了Shift鍵,不管是否按下了Shift鍵都會(huì)得到相同的Key值(Key.A). 這里還存在一個(gè)問題。根據(jù)Windows鍵盤的設(shè)置,持續(xù)按下一個(gè)鍵一段時(shí)間,會(huì)重復(fù)引發(fā)按鍵事件。例如,保持按下A鍵,顯然會(huì)在文本框中輸入一系列A字符。同樣,按下Shift鍵一段時(shí)間也會(huì)得到多個(gè)按鍵和一系列KeyDown事件。按下Shift+A鍵進(jìn)行測(cè)試的真實(shí)情況是,文本框?qū)嶋H上會(huì)為Shift鍵引發(fā)一系列KeyDown事件,然后為A鍵引發(fā)KeyDown事件,隨后是TextInput事件(對(duì)于文本框,是TextChanged事件),最后是為Shift鍵和A鍵引發(fā)KeyUp事件。如果希望忽略這些重復(fù)的Shift鍵,可以通過檢查KeyEventArgs.IsRepeat屬性,確定按鍵是不是因?yàn)榘醋℃I導(dǎo)致的結(jié)果,如下所示: if ((bool)chkHandle.IsChecked && e.IsRepeat) return; KeyDown事件發(fā)生后,接著發(fā)生PreviewTextInput事件(因?yàn)門extBox控件掛起了TextInput事件,所以不會(huì)發(fā)生TextInput事件)。此時(shí),文本尚未出現(xiàn)在控件中。 TextInput事件使用TextCompositionEventArgs對(duì)象提供代碼。該對(duì)象包含Text屬性,該屬性提供了處理過的文本,它們是控件即將接受到得文本。下面的代碼將這些文本添加到上圖所示的列表中: private void TextInput(object sender, TextCompositionEventArgs e) { string message = "Event:" + e.RoutedEvent + " Text:" + e.Text; this.lstMessages.Items.Add(message); } 理想情況下,可在控件(如TextBox控件)中使用PreviewTextInput事件執(zhí)行驗(yàn)證工作。例如,如果構(gòu)建只能輸入數(shù)字的文本框,可確保當(dāng)前按鍵不是字母,如果是就設(shè)置Handled標(biāo)志??上?,對(duì)于某些可能希望處理的鍵不會(huì)觸發(fā)PreviewTextInput事件。例如,如果在文本框中按下了空格鍵,將直接繞過PreviewTextInput事件,這意味著還需要處理PreviewKeyDown事件。 但在PreviewKeyDown事件處理程序中編寫出可靠的驗(yàn)證邏輯是比較困難的,因?yàn)樵诖酥恢繩ey值,這是級(jí)別很低的信息。例如,Key枚舉區(qū)分?jǐn)?shù)字鍵盤和普通鍵盤字母以上的數(shù)字鍵。這意味著根據(jù)按下數(shù)字9的方式,可能得到的值Key.D9或Key.NumPad9.驗(yàn)證所有這些允許使用的鍵值至少可以說是非??菰锏?。 一種選擇是使用KeyConverter類將Key值轉(zhuǎn)換為更有用的字符串。例如,使用KeyConverter.ConverterToString()方法,Key.D9和Key.NumPad9都返回字符串“9”。如果只使用Key.ToString()方法,將得到不那么有用的枚舉名稱(D9或NumPad9): KeyConverter converter=new KeyConverter(); string key=converter.ConverterToString(e.key); 然而,即使使用KeyConverter類也存在缺陷,因?yàn)閷?duì)于不會(huì)產(chǎn)生文本輸入的按鍵,會(huì)得到更長(zhǎng)一點(diǎn)的文本(如Backspace). 最好同事處理PreviewTextInput事件(該事件負(fù)責(zé)大多數(shù)驗(yàn)證)和PreviewKeyDown事件,PreviewKeyDown用于那些在文本框中不會(huì)引發(fā)PreviewTextInput事件的按鈕(例如空格鍵)。下面是完成這一工作的簡(jiǎn)單解決方案: 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; } } 可將這些事件處理程序關(guān)聯(lián)到單個(gè)文本框,或在更高層次的容器(例如,包含幾個(gè)只允許輸入數(shù)字的文本框的StackPanel面板)中關(guān)聯(lián)他們,這樣做效率更高。 二、焦點(diǎn) 在Windows世界中,用戶每次只能使用一個(gè)控件。當(dāng)前接受用戶按鍵的控件時(shí)具有焦點(diǎn)控件。有時(shí),有焦點(diǎn)的控件的外觀不同。例如,WPF按鈕使用藍(lán)色陰影顯示它具有焦點(diǎn)。 為讓控件能接受焦點(diǎn),必須將Focusable屬性設(shè)置為true,這是所有控件的默認(rèn)值。 有趣的是,F(xiàn)ocusable屬性是在UIElement類中定義的,這意味著其他非控件元素也可以獲得焦點(diǎn)。通常,對(duì)于非控件類,F(xiàn)ocusable屬性默認(rèn)設(shè)置為false,但也可以設(shè)置為true。例如,使用布局容器(如StackPanel面板)測(cè)試這一點(diǎn)——當(dāng)它獲得焦點(diǎn)時(shí),會(huì)在面板邊緣的周圍顯示一條點(diǎn)劃線邊框。 為將焦點(diǎn)從一個(gè)元素移到另一個(gè)元素,用戶可單擊鼠標(biāo)或使用Tab鍵和方向鍵。以前的開發(fā)框架強(qiáng)制編程人員確保Tab鍵以合理方式移動(dòng)焦點(diǎn)(通常是從左項(xiàng)右,然后從上到下),并且確保在窗口第一次顯示時(shí)正確的控件獲得焦點(diǎn)。在WPF中,不必在完成這些額外工作,因?yàn)閃PF使用層次結(jié)構(gòu)的元素布局實(shí)現(xiàn)了Tab鍵切換焦點(diǎn)的順序。本質(zhì)上,按下Tab鍵會(huì)將焦點(diǎn)移到當(dāng)前元素的第一個(gè)子元素,如果當(dāng)前元素沒有子元素,會(huì)將焦點(diǎn)移到同級(jí)的下一個(gè)子元素。例如,如果在具有兩個(gè)StackPanel面板容器的窗口中使用Tab鍵轉(zhuǎn)移焦點(diǎn),焦點(diǎn)首先會(huì)通過第一個(gè)StackPanel面板中的所有控件,然后通過第二個(gè)StackPanel面板中的所有控件。 如果希望獲得控制使用Tab鍵轉(zhuǎn)移焦點(diǎn)順序的功能,可按數(shù)字順序設(shè)置每個(gè)控件的TabIndex屬性。Tablndex屬性為0的控件首先獲得焦點(diǎn),然后是次高的TabIndex值(例如首先是1,然后是2、3、4...等等)。如果多個(gè)元素具有相同的TabIndex值,WPF就使用自動(dòng)Tab順序,這意味著會(huì)跳過隨后最靠近的元素。 TabIndex屬性是在Control類中定義的,在該類中還定義了IsTabStop屬性。可通過將IsTabStop屬性設(shè)置為false來阻止控件被包含進(jìn)Tab鍵焦點(diǎn)順序。IsTabStop屬性和Focusable屬性之間的區(qū)別在于,如果控件的IsTabStop屬性被設(shè)置為false,控件仍可通過其他方式獲得焦點(diǎn)——通過編程(使用代碼調(diào)用Focus()方法)或通過鼠標(biāo)單擊。 不可見或禁用的控件(“變灰的控件”)通常會(huì)忽略Tab鍵焦點(diǎn)順序,并且不能被激活,不管TabIndex屬性、IsTabStop屬性以及Focusable屬性如何設(shè)置。為了隱藏或禁用某個(gè)控件,可分別設(shè)置Visibility屬性和IsEnabled屬性。 三、獲取鍵盤狀態(tài) 當(dāng)發(fā)生按鍵事件時(shí),經(jīng)常需要知道更多信息,而不僅要知道按下的是那個(gè)鍵。而且確定其他鍵是否同事被按下了也非常重要。這意味著可能需要檢查其他鍵的狀態(tài),特別是Shift、Ctrl和Alt等修飾鍵。 對(duì)于鍵盤事件(PreviewKeyDown、KeyDown、PreviewKeyUp和KeyUp),獲取這些信息比較容易。首先,KeyEventArgs對(duì)象包含KeyStates屬性,該屬性反映觸發(fā)事件的鍵的屬性。更有用的是,KeyboardDevice屬性為鍵盤上的所有鍵提供了相同的信息。 自然,KeyboardDevice屬性提供了KeyboardDevice類的一個(gè)實(shí)例。它的屬性包含當(dāng)前是哪個(gè)元素具有焦點(diǎn)(FocusedElement)以及當(dāng)事件發(fā)生時(shí)按下了哪些修飾鍵。修飾鍵包括Shift、Ctrl和Alt鍵,并且可使用位邏輯來檢查他們的狀態(tài)。如下所示: if((e.KeyboardDevice.Modifiers&ModifiersKeys.Control)==ModifierKeys.Control) { lblInfo.Text="You held the Control Key."; } KeyboardDevice屬性還提供了幾個(gè)簡(jiǎn)便方法,這些方法在下表中列出。對(duì)于這些方法中的每個(gè)方法,需要傳遞一個(gè)Key枚舉值。 表 KeyboardDevice屬性提供的方法 當(dāng)使用KeyEventArgs.KeyboardDevice屬性時(shí),代碼獲取虛擬鍵狀態(tài)(virtual key state)。這意味著獲取在事件發(fā)生時(shí)鍵盤的狀態(tài),這些狀態(tài)和鍵盤的當(dāng)前狀態(tài)未必相同。例如,分析一下當(dāng)用戶輸入速度超出代碼執(zhí)行速度時(shí)會(huì)發(fā)生什么情況?每次引發(fā)KeyPress事件時(shí),都將訪問觸發(fā)事件的按鍵,而不是剛輸入的字符。這幾乎總是想得到的行為。 然而,沒有限制在鍵盤事件中獲取鍵的信息,也可以隨時(shí)獲取鍵盤狀態(tài)信息。技巧是使用Keyboard類,該類和KeyboardDevice類非常類似,只是Keyboard類由靜態(tài)成員構(gòu)成。下面的例子使用Keyboard類檢查左邊Shift鍵的當(dāng)前狀態(tài): if(Keyboard.IsKeyDown(Key.LeftShift)) { lblInfo.Text="The left Shift is held down."; }
|
|