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

注解

按钮输入映射到各种设备（包括游戏控制器）的不同键值。

此表提供游戏控制器的映射详细信息。

按钮	键 值	OriginalKey 值
	空间	GamepadA 或 NavigationAccept
	逃跑	GamepadB 或 NavigationCancel
	GamepadX	GamepadX
	GamepadY	GamepadY
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	获取生成此密钥事件的输入设备的唯一 ID（不支持所有输入设备）。
Handled	获取或设置一个值，该值将路由事件标记为已处理。 true用于Handled防止事件路由上的大多数处理程序再次处理同一事件的值。
Key	获取与事件关联的 虚拟键 。 根据输入设备，这可以是映射值。 有关原始未映射的事件数据，请参阅 OriginalKey 属性。
KeyStatus	获取一个结构值，该值报告按键的各种系统检测到的特征，包括重复计数和菜单状态。
OriginalKey	获取与事件关联的原始未映射 虚拟密钥 。 根据输入设备，输入按钮可能映射到不同的键值。 有关映射的事件值，请参阅 Key 属性。
OriginalSource	获取对引发事件的对象的引用。 这通常是控件的模板部分，而不是应用 UI 中声明的元素。 (继承自 RoutedEventArgs)

另请参阅

• RoutedEventArgs