UIElement.KeyDown Kejadian

Definisi

Ruang nama:

Microsoft.UI.Xaml

Terjadi ketika tombol keyboard ditekan saat UIElement memiliki fokus.

public:
 virtual event KeyEventHandler ^ KeyDown;

// Register
event_token KeyDown(KeyEventHandler const& handler) const;

// Revoke with event_token
void KeyDown(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;

public event KeyEventHandler KeyDown;

function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;

Public Custom Event KeyDown As KeyEventHandler 

<uiElement KeyDown="eventhandler"/>

Jenis Acara

KeyEventHandler

Keterangan

Kontrol di UI Anda menghasilkan peristiwa keyboard hanya ketika mereka memiliki fokus input. Secara default, elemen pertama yang dapat difokuskan di pohon visual diberikan fokus oleh sistem. Kontrol individual mendapatkan fokus saat pengguna mengklik atau mengetuk langsung pada kontrol tersebut di tata letak atau menggunakan tombol Tab untuk melangkah ke urutan tab dalam area konten. Anda juga dapat memfokuskan kontrol secara terprogram dengan memanggil UIElement.Focus(Microsoft.UI.Xaml.FocusState).

KeyDown adalah peristiwa yang dirutekan. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

KeyDown menggunakan data peristiwa KeyRoutedEventArgs . Properti yang paling relevan dari KeyRoutedEventArgs untuk sebagian besar skenario handler adalah Key dan mungkin KeyStatus. Untuk informasi selengkapnya tentang menangani peristiwa keyboard, termasuk contoh kode untuk menentukan metode KeyEventHandler , lihat Interaksi keyboard.

Salah satu skenario untuk menangani peristiwa keyboard adalah mendukung kunci akses atau tombol akselerator untuk aplikasi, atau wilayah atau kontrol dalam aplikasi. Untuk informasi selengkapnya tentang skenario ini, lihat Aksesibilitas keyboard.

Kontrol Windows Runtime tertentu mungkin memiliki penanganan berbasis kelas untuk peristiwa input KeyDown. Jika demikian, kontrol mungkin memiliki penimpaan untuk metode OnKeyDown. Biasanya handler kelas ini dimaksudkan untuk memproses subset penekanan tombol yang memungkinkan interaksi pengguna berbasis keyboard dengan kontrol tersebut. Sering kali, interaksi ini mendukung fitur aksesibilitas keyboard. Jika penekanan tombol ditangani oleh penanganan berbasis kelas, maka penekanan tombol dianggap sudah ditangani, dan peristiwa KeyDown tidak dinaikkan untuk penanganan oleh penangan kode pengguna pada kontrol tersebut untuk kunci tersebut secara khusus. Biasanya, ini hanya untuk beberapa kunci khusus. Misalnya, ButtonBase memiliki penanganan kelas sehingga tombol Spasi dan tombol Enter ditangani sebagai keyboard yang setara untuk memanggil Tombol. Yang menyediakan keyboard bawaan yang setara untuk mengetuk tombol atau mengkliknya dengan mouse dan memungkinkan skenario aksesibilitas menggunakan UI dan tombol hanya menggunakan keyboard. Tetapi kunci lain selain Space atau Enter masih akan mengaktifkan peristiwa KeyDown dan KeyUp untuk Button. Untuk informasi selengkapnya tentang cara kerja penanganan berbasis kelas untuk peristiwa, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

KeyDown mendukung kemampuan untuk melampirkan penanganan aktivitas ke rute yang akan dipanggil meskipun data peristiwa untuk peristiwa ditandai Ditangani. Lihat AddHandler.

Lihat juga

• KeyRoutedEventArgs
• KeyUp
• GotFocus
• OnKeyDown(KeyRoutedEventArgs)
• Interaksi keyboard
• Gambaran umum peristiwa dan peristiwa yang dirutekan
• Sampel peristiwa input pengguna XAML