共用方式為


KeyRoutedEventArgs 類別

定義

提供 KeyUpKeyDown 路由事件的事件資料。

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
屬性

Windows 需求

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

備註

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

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

按鈕

50

GamepadDPadUp/Down/Left/RightGamepadDPadUp/Down/Left/Right 或 NavigationUp/Down/Left/Right
GamePad 搖桿/搖桿GamepadLeftThumbstickButton/Up/Down/Left/Right 或 GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right 或 GamepadRightThumbstickButton/Up/Down/Left/Right 或 NavigationUp/Down/Left/Right
遊戲台觸發程式GamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
遊戲台凸起/雙手GamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
遊戲台功能表按鈕GamepadMenuGamepadMenu 或 NavigationMenu
遊戲台檢視按鈕GamepadViewGamepadView 或 NavigationView

版本歷程記錄

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

屬性

DeviceId

取得產生此金鑰事件之輸入裝置的唯一識別碼。

使用 DeviceId 區分可產生重要事件的所有連線裝置,例如多個遊戲控制器。

所有輸入裝置都不支援 DeviceId。

Handled

取得或設定值,這個值會將路由事件標示為已處理。 Handledtrue值可防止事件路由上的大部分處理常式再次處理相同的事件。

Key

取得與 事件相關聯的 虛擬金鑰

視輸入裝置而定,這可以是對應的值。 如需未經處理、未對應的事件資料,請參閱 OriginalKey 屬性。

KeyStatus

取得結構值,報告各種系統偵測到的按鍵特性,包括重複計數和功能表狀態。

OriginalKey

取得與 事件相關聯的原始未對應的 虛擬金鑰

視輸入裝置而定,輸入按鈕可能會對應至不同的索引鍵值。 如需對應的事件值,請參閱 Key 屬性。

OriginalSource

取得引發事件之 物件的參考。 這通常是控制項的範本部分,而不是在應用程式 UI 中宣告的專案。

(繼承來源 RoutedEventArgs)

適用於

另請參閱