KeyRoutedEventArgs 類別

定義

命名空間:

Microsoft.UI.Xaml.Input

提供 KeyUp 和 KeyDown 路由事件的事件資料。

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyRoutedEventArgs final : RoutedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class KeyRoutedEventArgs : RoutedEventArgs

Public NotInheritable Class KeyRoutedEventArgs
Inherits RoutedEventArgs

繼承

Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

按鈕輸入會對應到各種裝置的不同按鍵值，包括遊戲控制器。

下表提供遊戲控制器的對應詳細資料。

按鈕	50	GamepadDPadUp/Down/Left/Right	GamepadDPadUp/Down/Left/Right 或 NavigationUp/Down/Left/Right
	GamepadLeftThumbstickButton/Up/Down/Left/Right 或 GamepadRightThumbstickButton/Up/Down/Left/Right	GamepadLeftThumbstickButton/Up/Down/Left/Right 或 GamepadRightThumbstickButton/Up/Down/Left/Right 或 NavigationUp/Down/Left/Right
	GamePadRightTrigger/LeftTrigger	GamePadRightTrigger/LeftTrigger
	GamePadRightShoulder/LeftShoulder	GamePadRightShoulder/LeftShoulder
	GamepadMenu	GamepadMenu 或 NavigationMenu
	GamepadView	GamepadView 或 NavigationView

屬性

DeviceId	取得產生此索引鍵事件之輸入裝置的唯一識別碼， (所有輸入裝置都不支援) 。
Handled	取得或設定值，這個值會將路由事件標示為已處理。 true的值 Handled 可防止事件路由上的大部分處理常式再次處理相同的事件。
Key	取得與 事件相關聯的 虛擬金鑰 。 視輸入裝置而定，這可以是對應的值。 如需未經處理、未對應的事件資料，請參閱 OriginalKey 屬性。
KeyStatus	取得結構值，報告各種系統偵測到的按鍵特性，包括重複計數和功能表狀態。
OriginalKey	取得與事件相關聯的原始未對應的 虛擬金鑰 。 視輸入裝置而定，輸入按鈕可能會對應至不同的索引鍵值。 如需對應的事件值，請參閱 Key 屬性。
OriginalSource	取得引發事件之 物件的參考。 這通常是控制項的範本部分，而不是在應用程式 UI 中宣告的專案。 (繼承來源 RoutedEventArgs)

另請參閱

• RoutedEventArgs