Bagikan melalui

Mengontrol peristiwa (Formulir Windows .NET)

  • Artikel

Kontrol menyediakan peristiwa yang dimunculkan saat pengguna berinteraksi dengan kontrol atau ketika status kontrol berubah. Artikel ini menjelaskan peristiwa umum yang dibagikan oleh sebagian besar kontrol, peristiwa yang diangkat oleh interaksi pengguna, dan peristiwa yang unik untuk kontrol tertentu. Untuk informasi selengkapnya tentang peristiwa di Formulir Windows, lihat Gambaran umum peristiwa dan Penanganan dan peningkatan peristiwa.

Penting

Dokumentasi Panduan Desktop untuk .NET 7 dan .NET 6 sedang dibangun.

Untuk informasi selengkapnya tentang cara menambahkan atau menghapus penanganan aktivitas kontrol, lihat Cara menangani peristiwa.

Peristiwa umum

Kontrol menyediakan lebih dari 60 peristiwa melalui kelas Controldasar . Ini termasuk Paint peristiwa, yang menyebabkan kontrol digambar, peristiwa yang terkait dengan menampilkan jendela, seperti Resize peristiwa dan Layout , dan peristiwa mouse dan keyboard tingkat rendah. Beberapa peristiwa tingkat rendah disintesis oleh Control ke dalam peristiwa semantik seperti Click dan DoubleClick. Sebagian besar peristiwa bersama termasuk dalam kategori ini:

  • Peristiwa mouse
  • Peristiwa keyboard
  • Properti mengubah peristiwa
  • Peristiwa lainnya

Peristiwa mouse

Mengingat Formulir Windows adalah teknologi Antarmuka Pengguna (UI), input mouse adalah cara utama pengguna berinteraksi dengan aplikasi Formulir Windows. Semua kontrol menyediakan peristiwa dasar terkait mouse:

Untuk informasi selengkapnya, lihat Menggunakan peristiwa mouse.

Peristiwa keyboard

Jika kontrol merespons input pengguna, seperti TextBox atau Button kontrol, peristiwa input yang sesuai akan dinaikkan untuk kontrol. Kontrol harus difokuskan untuk menerima peristiwa keyboard. Beberapa kontrol, seperti Label kontrol, tidak dapat difokuskan dan tidak dapat menerima peristiwa keyboard. Berikut ini adalah daftar peristiwa keyboard:

Untuk informasi selengkapnya, lihat Menggunakan peristiwa keyboard.

Properti mengubah peristiwa

Formulir Windows mengikuti Pola PropertyNameChanged untuk properti yang memiliki peristiwa perubahan. Mesin pengikatan data yang disediakan oleh Formulir Windows mengenali pola ini dan terintegrasi dengan baik dengannya. Saat membuat kontrol Anda sendiri, terapkan pola ini.

Pola ini menerapkan aturan berikut, menggunakan properti FirstName sebagai contoh:

  • Beri nama properti Anda: FirstName.
  • Buat peristiwa untuk properti menggunakan pola PropertyNameChanged: FirstNameChanged.
  • Buat metode privat atau terlindungi menggunakan pola OnPropertyNameChanged: OnFirstNameChanged.

FirstName Jika kumpulan properti memodifikasi nilai backing, OnFirstNameChanged metode dipanggil. Metode ini OnFirstNameChanged meningkatkan FirstNameChanged peristiwa.

Berikut adalah beberapa peristiwa perubahan properti umum untuk kontrol:

Event Deskripsi
BackColorChanged Terjadi ketika nilai BackColor properti berubah.
BackgroundImageChanged Terjadi ketika nilai BackgroundImage properti berubah.
BindingContextChanged Terjadi ketika nilai BindingContext properti berubah.
DockChanged Terjadi ketika nilai Dock properti berubah.
EnabledChanged Terjadi ketika Enabled nilai properti telah berubah.
FontChanged Terjadi ketika Font nilai properti berubah.
ForeColorChanged Terjadi ketika ForeColor nilai properti berubah.
LocationChanged Terjadi ketika Location nilai properti telah berubah.
SizeChanged Terjadi ketika Size nilai properti berubah.
VisibleChanged Terjadi ketika Visible nilai properti berubah.

Untuk daftar lengkap peristiwa, lihat bagian Peristiwa di Kelas Kontrol.

Peristiwa lainnya

Kontrol juga akan menaikkan peristiwa berdasarkan status kontrol, atau interaksi lain dengan kontrol. Misalnya, HelpRequested peristiwa dinaikkan jika kontrol memiliki fokus dan pengguna menekan tombol F1 . Kejadian ini juga dimunculkan jika pengguna menekan tombol Bantuan peka konteks pada formulir, lalu menekan kursor bantuan pada kontrol.

Contoh lain adalah ketika kontrol diubah, dipindahkan, atau diubah ukurannya Paint , peristiwa dinaikkan. Acara ini memberi pengembang kesempatan untuk menarik kontrol dan mengubah penampilannya.

Untuk daftar lengkap peristiwa, lihat bagian Peristiwa di Kelas Kontrol.

Baca juga