UIElement.KeyDown Kejadian

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
Edit

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 hanya menghasilkan peristiwa keyboard saat 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 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 Control.Focus.

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 KeyRoutedEventArgs yang paling relevan 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 kunci 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, dan 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 Spasi atau Enter masih akan mengaktifkan peristiwa KeyDown dan KeyUp untuk Tombol. 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.

Berlaku untuk

Lihat juga