KeyEventArgs 类

定义

命名空间:

System.Windows.Input

程序集:

PresentationCore.dll

为和KeyDown路由事件以及相关的附加事件和预览事件提供数据KeyUp。

public ref class KeyEventArgs : System::Windows::Input::KeyboardEventArgs

public class KeyEventArgs : System.Windows.Input.KeyboardEventArgs

type KeyEventArgs = class
    inherit KeyboardEventArgs

Public Class KeyEventArgs
Inherits KeyboardEventArgs

继承

Object

EventArgs

RoutedEventArgs

InputEventArgs

KeyboardEventArgs

KeyEventArgs

注解

此事件数据类用于以下附加事件：

• Keyboard.KeyUp

• Keyboard.KeyDown

• Keyboard.PreviewKeyUp

• Keyboard.PreviewKeyDown

此事件数据类还与基元素上的以下路由事件一起使用。 这些路由事件转发前面列出的附加事件，使其更易于 WPF 中的常规元素模型访问。

• UIElement.KeyUp

• UIElement.KeyDown

• UIElement.PreviewKeyUp

• UIElement.PreviewKeyDown

• ContentElement.KeyUp

• ContentElement.KeyDown

• ContentElement.PreviewKeyUp

• ContentElement.PreviewKeyDown

附加事件和基元素路由事件共享其事件数据，路由事件的冒泡和隧道版本也共享事件数据。 这可能会影响事件在传输事件路由时处理的特征。 有关详细信息，请参阅 输入概述。

键可以同时处于向上和切换状态或向下和切换状态。 因此，确定键是向上还是向下键并不如将值检查 KeyStates 为数值那么简单。 相反，应通过将该值视为标志枚举来检查该值。 使用第一位 AND 的比较。 或者，使用帮助程序属性 IsUp， IsDown并确定 IsToggled 给定键是向上、关闭还是已切换。

构造函数

名称	说明
KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)	初始化 KeyEventArgs 类的新实例。

属性

名称	说明
DeadCharProcessedKey	获取作为死键组合的一部分的键，以创建单个组合字符。
Device	获取启动此事件的输入设备。 (继承自 InputEventArgs)
Handled	获取或设置一个值，该值指示路由事件在传输路由时的事件处理的当前状态。 (继承自 RoutedEventArgs)
ImeProcessedKey	获取事件引用的键盘键（如果键将由输入法编辑器（IME）处理。
InputSource	获取提供此输入的输入源。
IsDown	获取一个值，该值指示事件引用的键是否处于关闭状态。
IsRepeat	获取一个值，该值指示事件引用的键盘键是否为重复键。
IsToggled	获取一个值，该值指示事件引用的键是否处于切换状态。
IsUp	获取一个值，该值指示事件引用的键是否处于启动状态。
Key	获取与事件关联的键盘键。
KeyboardDevice	获取与输入事件关联的键盘设备。 (继承自 KeyboardEventArgs)
KeyStates	获取与此事件关联的键盘键的状态。
OriginalSource	获取由纯命中测试确定的原始报告源，然后再由父类进行任何可能的 Source 调整。 (继承自 RoutedEventArgs)
RoutedEvent	获取或设置 RoutedEvent 与此 RoutedEventArgs 实例关联的项。 (继承自 RoutedEventArgs)
Source	获取或设置对引发事件的对象的引用。 (继承自 RoutedEventArgs)
SystemKey	获取事件引用的键盘键（如果键将由系统处理）。
Timestamp	获取发生此事件的时间。 (继承自 InputEventArgs)

方法

名称	说明
InvokeEventHandler(Delegate, Object)	以特定于类型的方式调用事件处理程序，从而提高事件系统效率。
OnSetSource(Object)	在派生类中重写时，每当实例属性的值 Source 发生更改时，都提供通知回调入口点。 (继承自 RoutedEventArgs)

另请参阅

• KeyEventHandler
• KeyboardEventArgs
• KeyboardEventHandler