Control.ProcessCmdKey(Message, Keys) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Control.cs

Memproses kunci perintah.

protected:
 virtual bool ProcessCmdKey(System::Windows::Forms::Message % msg, System::Windows::Forms::Keys keyData);

protected virtual bool ProcessCmdKey(ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData);

abstract member ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool
override this.ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool

Protected Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys) As Boolean

Parameter

msg

Message

Message, diteruskan oleh referensi, yang mewakili pesan jendela untuk diproses.

keyData

Keys

Salah Keys satu nilai yang mewakili kunci untuk diproses.

Mengembalikan

Boolean

true jika karakter diproses oleh kontrol; jika tidak, false.

Keterangan

Metode ini dipanggil selama pra-pemrosesan pesan untuk menangani kunci perintah. Kunci perintah adalah kunci yang selalu diutamakan daripada kunci input reguler. Contoh kunci perintah termasuk akselerator dan pintasan menu. Metode harus kembali true untuk menunjukkan bahwa metode tersebut telah memproses kunci perintah, atau false untuk menunjukkan bahwa kunci tersebut bukan kunci perintah. Metode ini hanya dipanggil ketika kontrol dihosting dalam aplikasi Formulir Windows atau sebagai kontrol ActiveX.

Metode ini ProcessCmdKey pertama-tama menentukan apakah kontrol memiliki ContextMenu, dan jika demikian, memungkinkan ContextMenu untuk memproses kunci perintah. Jika kunci perintah bukan pintasan menu dan kontrol memiliki induk, kunci diteruskan ke metode induk ProcessCmdKey . Efek bersihnya adalah bahwa kunci perintah "menggelegak" hierarki kontrol. Selain tombol yang ditekan pengguna, data kunci juga menunjukkan tombol pengubah mana, jika ada, ditekan pada saat yang sama dengan kunci. Tombol pengubah mencakup tombol SHIFT, CTRL, dan ALT.

Catatan Bagi Inheritor

Saat mengambil alih ProcessCmdKey(Message, Keys) metode di kelas turunan, kontrol harus kembali true menunjukkan bahwa metode tersebut telah memproses kunci. Untuk kunci yang tidak diproses oleh kontrol, hasil pemanggilan metode kelas ProcessCmdKey(Message, Keys) dasar harus dikembalikan. Kontrol jarang terjadi, jika pernah, perlu mengambil alih metode ini.