【WPF學習】第十六章鍵盤輸入

　　當使用者按下鍵盤上的一個鍵時，就會發生一系列事件。下表根據他們的發生順序列出了這些事件：

表所有元素的鍵盤事件(按順序)

　　鍵盤處理永遠不會像上面看到的這麼簡單。一些控件可能會挂起這些事件中的某些事件，進而可執行自己更特殊的鍵盤處理。最明顯的例子是TextBox控件，它挂起了TextInput事件。對于一些按鍵，TextBox控件還挂起了KeyDown事件，如方向鍵。對于此類情形，通常仍可使用隧道路由事件(PreviewTextInput和PreviewKeyDown事件).

　　TextBox控件還添加了名為TextChanged的新事件。在按鍵導緻文本框中的文本發生改變之後立即引發該事件。這時，在文本框中已經可以看到新的文本，是以阻止不需要的按鍵已為時太晚。

一、處理按鍵事件

　　了解鍵盤事件的最好方式是使用簡單的示例程式，如下圖所示。該例在一個文本框中監視所有可能的鍵盤事件，并在發生時給出報告。下圖顯示了文本框中輸入大寫A鍵時結果。

　　上面示例的完整代碼如下所示：

【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枚舉值，該枚舉值辨別了按下或釋放的鍵。下面是上圖處理鍵盤事件的事件處理程式：

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.";
}

作者：Peter Luo

出處：https://www.cnblogs.com/Peter-Luo/

本文版權歸作者和部落格園共有，歡迎轉載，但必須給出原文連結，并保留此段聲明，否則保留追究法律責任的權利。

【WPF學習】第十六章鍵盤輸入

繼續閱讀

算法之-判斷某個整數是否為素數的自定義函數：

XAML中綁定一個枚舉

wpf連接配接資料庫

WPF學習感受WPF的XAML好的UI類庫

對CPersistentFrame的問題

閑話WinFrom與WPF(4) 架構篇——結合VS擴充,插件式開發架構

WPF 中 InitializeComponent 不存在解決方案

第18章自定義元素(1)——概述

Bluetooth Service Classes and Device Classes

Windows Mobile 上使用鍵盤鈎子

WPF實作3D粒子波浪效果

Android控制螢幕方向的改變

重定向 1>&2 2>&1

WPF開發帶水印的輸入框

【WPF學習】第十六章 鍵盤輸入

繼續閱讀

【WPF學習】第十六章鍵盤輸入