KeyEventArgs 类

定义

命名空间:

Windows.UI.Core

包含虚拟键事件返回的参数。

public ref class KeyEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class KeyEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class KeyEventArgs

Public NotInheritable Class KeyEventArgs

继承

Object Platform::Object IInspectable KeyEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

ICoreWindowEventArgs

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

启用输入法编辑器 (输入法) 时，Windows 10应用不会收到此事件。 输入法编辑器 (输入法) 处理所有键盘输入并将 Handled 设置为 true。

Windows Phone此 API 仅在本机应用中受支持。

此对象由为以下事件之一注册的委托返回：

• CoreWindow.KeyDown
• CoreWindow.KeyUp

void SetWindow(CoreWindow const & window)
{
    ...
    window.KeyDown({ this, &App::OnKeyDown });
    window.KeyUp({ this, &App::OnKeyUp });
}

// Keypress data is in KeyEventArgs.
void OnKeyDown(Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::KeyEventArgs const& /* args */) {}

void OnKeyUp(Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::KeyEventArgs const& /* args */) {}

// returning keypress events data through KeyEventArgs
void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication::Run(), provided for context
    _In_ CoreWindow^ window
    )
{
    // ...
    window->KeyDown +=
        ref new TypedEventHandler<CoreWindow^, KeyEventArgs^>(this, &CoreWindowEvents::OnKeyDown);
    window->KeyUp +=
        ref new TypedEventHandler<CoreWindow^, KeyEventArgs^>(this, &CoreWindowEvents::OnKeyUp);

    // ...
}

注意

此类不是敏捷类，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅 线程处理和封送处理 (C++/CX) 。

版本历史记录

Windows 版本	SDK 版本	增值
1607	14393	DeviceId

属性

DeviceId	获取生成此密钥事件的输入设备的唯一 ID。 使用 DeviceId 区分可生成关键事件的设备，例如多个游戏控制器。 并非所有输入设备都支持 DeviceId。
Handled	获取或设置是否已处理按键事件。
KeyStatus	获取触发事件时键的状态。
VirtualKey	获取映射到按下的键的虚拟键。

另请参阅

• KeyDown
• KeyUp