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 中引入)

注解

按钮输入映射到各种设备的不同键值。

此表提供了游戏板和远程设备的映射详细信息。

Button	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 or GamepadRightThumbstickButton/Up/Down/Left/Right or NavigationUp/Down/Left/Right
	GamePadRightTrigger/LeftTrigger	GamePadRightTrigger/LeftTrigger
	GamePadRightShoulder/LeftShoulder	GamePadRightShoulder/LeftShoulder
	GamepadMenu	GamepadMenu 或 NavigationMenu
	GamepadView	GamepadView 或 NavigationView

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	DeviceId

属性

DeviceId	获取生成此密钥事件的输入设备的唯一 ID。 使用 DeviceId 区分可以生成关键事件的所有连接的设备，例如多个游戏控制器。 并非所有输入设备都支持 DeviceId。
Handled	获取或设置一个值，该值将路由事件标记为已处理。 Handled 的 true 值可防止事件路由中的大多数处理程序再次处理同一事件。
Key	获取与 事件关联的 虚拟密钥 。 根据输入设备，这可以是映射值。 有关原始的未映射事件数据，请参阅 OriginalKey 属性。
KeyStatus	获取一个结构值，该值报告按键的各种系统检测到的特征，包括重复计数和菜单状态。
OriginalKey	获取与 事件关联的原始未映射 虚拟密钥 。 输入按钮可能映射到不同的键值，具体取决于输入设备。 有关映射的事件值，请参阅 Key 属性。
OriginalSource	获取对引发 事件的 对象的引用。 这通常是控件的模板部分，而不是在应用 UI 中声明的元素。 (继承自 RoutedEventArgs)

另请参阅

• RoutedEventArgs
• XAML WebView 控件示例