KeyRoutedEventArgs 類別

定義

命名空間:

Windows.UI.Xaml.Input

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

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

按鈕輸入會對應到各種裝置的不同索引鍵值。

下表提供遊戲台和遠端裝置的對應詳細資料。

按鈕	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

版本歷程記錄

Windows 版本	SDK 版本	新增值
1607	14393	DeviceId

屬性

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

另請參閱

• RoutedEventArgs
• XAML WebView 控制項範例