KeyEventArgs Kelas

Definisi

Ruang nama:

Windows.UI.Core

Berisi argumen yang dikembalikan oleh peristiwa kunci virtual.

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

Warisan

Object Platform::Object IInspectable KeyEventArgs

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan

ICoreWindowEventArgs

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Windows 10 Apps tidak menerima peristiwa ini saat Editor Metode Input (IME) diaktifkan. Editor Metode Input (IME) menangani semua input keyboard dan set yang Ditangani ke true.

Windows Phone API ini hanya didukung di aplikasi asli.

Objek ini dikembalikan oleh delegasi yang terdaftar untuk salah satu peristiwa berikut:

• 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);

    // ...
}

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX).

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	DeviceId

Properti

DeviceId	Mendapatkan ID unik untuk perangkat input yang menghasilkan peristiwa kunci ini. Gunakan DeviceId untuk membedakan antara perangkat yang dapat menghasilkan peristiwa utama, seperti beberapa pengontrol game. DeviceId tidak didukung untuk semua perangkat input.
Handled	Mendapatkan atau mengatur apakah peristiwa penekanan tombol ditangani.
KeyStatus	Mendapatkan status kunci pada saat peristiwa dipicu.
VirtualKey	Mendapatkan kunci virtual yang memetakan ke tombol yang ditekan.

Lihat juga

• KeyDown
• KeyUp