KeyEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
- Penerapan
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:
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.
|
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. |