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 仅在本机应用中受支持。

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

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

获取映射到按下的键的虚拟键。

适用于

另请参阅