KeyEventArgs 類別

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

提供 KeyUp 和 KeyDown 路由事件的資料，以及相關附加事件和預覽事件。

public ref class KeyEventArgs : System::Windows::Input::KeyboardEventArgs

public class KeyEventArgs : System.Windows.Input.KeyboardEventArgs

type KeyEventArgs = class
    inherit KeyboardEventArgs

Public Class KeyEventArgs
Inherits KeyboardEventArgs

繼承

Object

EventArgs

RoutedEventArgs

InputEventArgs

KeyboardEventArgs

KeyEventArgs

備註

此事件資料類別會與下列附加事件搭配使用：

• Keyboard.KeyUp

• Keyboard.KeyDown

• Keyboard.PreviewKeyUp

• Keyboard.PreviewKeyDown

此事件數據類別也會與基底元素上的下列路由事件搭配使用。 這些路由事件會轉送先前列出的附加事件，使其更容易存取 WPF 中的一般專案模型。

• UIElement.KeyUp

• UIElement.KeyDown

• UIElement.PreviewKeyUp

• UIElement.PreviewKeyDown

• ContentElement.KeyUp

• ContentElement.KeyDown

• ContentElement.PreviewKeyUp

• ContentElement.PreviewKeyDown

附加事件和基底元素路由事件會共用其事件數據，而路由事件的反升和通道版本也會共用事件數據。 這可能會影響事件在傳送事件路由時所處理的特性。 如需詳細資訊，請參閱 輸入概觀。

索引鍵可以同時處於向上和切換狀態，或是向下和切換狀態。 基於這個理由，判斷索引鍵是向上還是向下，不像檢查 KeyStates 數值的值一樣簡單。 相反地，您應該將其視為旗標列舉來檢查值。 使用第一個 AND 位的比較。 或者，使用協助程序屬性 IsUp、 IsDown和 IsToggled 來判斷指定的索引鍵是向上、向下或切換。

建構函式

KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)

初始化 KeyEventArgs 類別的新執行個體。

屬性

DeadCharProcessedKey	取得屬於廢鍵組合 (Dead Key Composition) 之一部分的按鍵，以建立單一組合 (Combined) 字元。
Device	取得初始化這個事件的輸入裝置。 (繼承來源 InputEventArgs)
Handled	取得或設定值，這個值表示路由事件在傳送路由時之事件處理的目前狀態。 (繼承來源 RoutedEventArgs)
ImeProcessedKey	如果輸入法編輯器 (輸入法) 處理按鍵，則取得 事件所參考的鍵盤按鍵。
InputSource	取得提供這個輸入的輸入來源。
IsDown	取得值，這個值指出事件參考的按鍵是否為已按下的狀態。
IsRepeat	取得值，這個值指出事件參考的鍵盤按鍵是否為重複的按鍵。
IsToggled	取得值，這個值指出事件參考的按鍵是否為已切換的狀態。
IsUp	取得值，這個值指出事件參考的按鍵是否為已釋放的狀態。
Key	取得與事件關聯的鍵盤按鍵。
KeyboardDevice	取得與輸入事件相關聯的鍵盤裝置。 (繼承來源 KeyboardEventArgs)
KeyStates	取得與這個事件關聯的鍵盤按鍵狀態。
OriginalSource	在父類別進行任何可能的 Source 調整之前，取得純點擊測試所判定的原始報告來源。 (繼承來源 RoutedEventArgs)
RoutedEvent	取得或設定與這個 RoutedEventArgs 執行個體相關聯的 RoutedEvent。 (繼承來源 RoutedEventArgs)
Source	取得或設定引發事件之物件的參考。 (繼承來源 RoutedEventArgs)
SystemKey	取得事件參考的鍵盤按鍵 (如果該按鍵將由系統處理)。
Timestamp	取得這個事件發生的時間。 (繼承來源 InputEventArgs)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InvokeEventHandler(Delegate, Object)	以型別專屬的方式叫用事件處理常式，這樣做能夠提升事件系統的效率。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnSetSource(Object)	在衍生類別中覆寫時，每當執行個體的 Source 屬性值變更，便會提供通知回呼進入點。 (繼承來源 RoutedEventArgs)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• KeyEventHandler
• KeyboardEventArgs
• KeyboardEventHandler