Peristiwa Mouse di Formulir Windows
Ketika Anda menangani input mouse, Anda biasanya ingin mengetahui lokasi penunjuk mouse dan status tombol mouse. Topik ini menyediakan detail tentang cara mendapatkan informasi ini dari peristiwa mouse, dan menjelaskan urutan peristiwa klik mouse dinaikkan dalam kontrol Formulir Windows. Untuk daftar dan deskripsi semua peristiwa mouse, lihat Cara Kerja Input Mouse di Formulir Windows. Lihat Juga Gambaran Umum Penanganan Aktivitas (Formulir Windows) dan Gambaran Umum Peristiwa (Formulir Windows).
Informasi Mouse
MouseEventArgs dikirim ke penangan peristiwa mouse yang terkait dengan mengklik tombol mouse dan melacak gerakan mouse. MouseEventArgs menyediakan informasi tentang status mouse saat ini, termasuk lokasi penunjuk mouse dalam koordinat klien, tombol mouse mana yang ditekan, dan apakah roda mouse telah digulir. Beberapa peristiwa mouse, seperti yang hanya memberi tahu ketika penunjuk mouse telah memasuki atau meninggalkan batas kontrol, mengirim EventArgs ke penanganan aktivitas tanpa informasi lebih lanjut.
Jika Anda ingin mengetahui status tombol mouse saat ini atau lokasi penunjuk mouse, dan Anda ingin menghindari penanganan peristiwa mouse, Anda juga dapat menggunakan MouseButtons properti dan MousePosition kelas Control . MouseButtons mengembalikan informasi tentang tombol mouse mana yang saat ini ditekan. mengembalikan MousePosition koordinat layar penunjuk mouse dan setara dengan nilai yang dikembalikan oleh Position.
Mengonversi Antara Koordinat Layar dan Klien
Karena beberapa informasi lokasi mouse berada dalam koordinat klien dan beberapa berada dalam koordinat layar, Anda mungkin perlu mengonversi titik dari satu sistem koordinat ke sistem koordinat lainnya. Anda dapat melakukan ini dengan mudah dengan menggunakan PointToClient metode dan PointToScreen yang tersedia di Control kelas .
Perilaku Peristiwa Klik Standar
Jika Anda ingin menangani peristiwa klik mouse dalam urutan yang tepat, Anda perlu mengetahui urutan peristiwa klik dinaikkan dalam kontrol Formulir Windows. Semua kontrol Formulir Windows menaikkan peristiwa klik dalam urutan yang sama ketika tombol mouse ditekan dan dilepaskan (terlepas dari tombol mouse mana), kecuali jika dicatat dalam daftar berikut untuk kontrol individual. Daftar berikut menunjukkan urutan peristiwa yang dinaikkan untuk satu klik tombol mouse:
MouseDown Acara.
Click Acara.
MouseClick Acara.
MouseUp Acara.
Berikut ini adalah urutan peristiwa yang dinaikkan untuk klik tombol mouse ganda:
MouseDown Acara.
Click Acara.
MouseClick Acara.
MouseUp Acara.
MouseDown Acara.
DoubleClick Acara. (Ini dapat bervariasi, tergantung pada apakah kontrol yang dimaksud memiliki bit gaya yang StandardDoubleClick diatur ke
true. Untuk informasi selengkapnya tentang cara mengatur sedikit ControlStyles , lihat SetStyle metode .)MouseDoubleClick Acara.
MouseUp Acara.
Untuk contoh kode yang menunjukkan urutan peristiwa klik mouse, lihat Cara: Menangani Peristiwa Input Pengguna di Kontrol Formulir Windows.
Kontrol Individu
Kontrol berikut ini tidak sesuai dengan perilaku peristiwa klik mouse standar:
-
Catatan
ComboBox Untuk kontrol, perilaku peristiwa yang dirinci nanti terjadi jika pengguna mengklik bidang edit, tombol, atau pada item dalam daftar.
Klik kiri: Click, MouseClick
Klik kanan: Tidak ada peristiwa klik yang dimunculkan
Klik dua kali kiri: Click, MouseClick; Click, MouseClick
Klik kanan dua kali: Tidak ada peristiwa klik yang dimunculkan
TextBox, , RichTextBoxListBox, MaskedTextBox, dan CheckedListBox kontrol
Catatan
Perilaku peristiwa yang dirinci nanti terjadi ketika pengguna mengklik di mana saja dalam kontrol ini.
Klik kiri: Click, MouseClick
Klik kanan: Tidak ada peristiwa klik yang dimunculkan
Klik dua kali kiri: Click, MouseClick, DoubleClick, MouseDoubleClick
Klik kanan dua kali: Tidak ada peristiwa klik yang dimunculkan
Kontrol ListView
Catatan
Perilaku peristiwa yang dirinci nanti hanya terjadi ketika pengguna mengklik item dalam ListView kontrol. Tidak ada peristiwa yang dinaikkan untuk klik di tempat lain pada kontrol. Selain peristiwa yang dijelaskan nanti, ada BeforeLabelEdit peristiwa dan AfterLabelEdit , yang mungkin menarik bagi Anda jika Anda ingin menggunakan validasi dengan ListView kontrol.
Klik kiri: Click, MouseClick
Klik kanan: Click, MouseClick
Klik dua kali kiri: Click, MouseClick; DoubleClick, MouseDoubleClick
Klik kanan dua kali: Click, MouseClick; DoubleClick, MouseDoubleClick
Kontrol TreeView
Catatan
Perilaku peristiwa yang dirinci nanti hanya terjadi ketika pengguna mengklik item itu sendiri atau di sebelah kanan item dalam TreeView kontrol. Tidak ada peristiwa yang dinaikkan untuk klik di tempat lain pada kontrol. Selain yang dijelaskan nanti, ada BeforeCheckperistiwa , , BeforeSelect, BeforeLabelEditAfterSelect, AfterCheck, dan AfterLabelEdit , yang mungkin menarik bagi Anda jika Anda ingin menggunakan validasi dengan TreeView kontrol.
Klik kiri: Click, MouseClick
Klik kanan: Click, MouseClick
Klik dua kali kiri: Click, MouseClick; DoubleClick, MouseDoubleClick
Klik kanan dua kali: Click, MouseClick; DoubleClick, MouseDoubleClick
Perilaku melukis kontrol pengalih
Alihkan kontrol, seperti kontrol yang berasal dari ButtonBase kelas , memiliki perilaku lukisan khas berikut dalam kombinasi dengan peristiwa klik mouse:
Pengguna menekan tombol mouse.
Kontrol melukis dalam keadaan tertekan.
Acara MouseDown dinaikkan.
Pengguna merilis tombol mouse.
Kontrol melukis dalam keadaan terangkat.
Acara Click dinaikkan.
Acara MouseClick dinaikkan.
Acara MouseUp dinaikkan.
Catatan
Jika pengguna memindahkan penunjuk keluar dari kontrol pengalih saat tombol mouse tidak berfungsi (seperti memindahkan mouse dari Button kontrol saat ditekan), kontrol pengalih akan mengecat dalam keadaan dinaikkan dan hanya peristiwa yang MouseUp terjadi. Peristiwa Click atau MouseClick tidak akan terjadi dalam situasi ini.
Baca juga
.NET Desktop feedback