pesan WM_SETHOTKEY

Dikirim ke jendela untuk mengaitkan kunci panas dengan jendela. Ketika pengguna menekan tombol panas, sistem mengaktifkan jendela.

#define WM_SETHOTKEY                    0x0032

Parameter-parameternya

wParam

Byte rendah kata berurutan rendah menentukan kode kunci virtual untuk dikaitkan dengan jendela.

Byte tinggi dari kata berurutan rendah bisa menjadi satu atau beberapa nilai berikut dari CommCtrl.h.

Nilai	Makna
HOTKEYF_ALT 0x04	Kunci ALT
HOTKEYF_CONTROL 0x02	Kunci CTRL
HOTKEYF_EXT 0x08	Kunci yang diperluas
HOTKEYF_SHIFT 0x01	Tombol SHIFT

Kata urutan tinggi wParam diabaikan.

Mengatur wParam ke NULL menghapus hot key yang terkait dengan jendela.

lParam

Parameter ini tidak digunakan.

Mengembalikan nilai

Nilai yang dikembalikan adalah salah satu dari yang berikut ini.

Mengembalikan nilai	Deskripsi
-1	Fungsi ini tidak berhasil; kunci panas tidak valid.
0	Fungsi ini tidak berhasil; jendela tidak valid.
1	Fungsi berhasil, dan tidak ada jendela lain yang memiliki kunci panas yang sama.
2	Fungsi berhasil, tetapi jendela lain sudah memiliki kunci panas yang sama.

Komentar

Kunci panas tidak dapat dikaitkan dengan jendela anak.

VK_ESCAPE, VK_SPACE, VK_TAB, dan VK_PACKET adalah hot key yang tidak valid.

Ketika pengguna menekan tombol panas, sistem menghasilkan pesan WM_SYSCOMMAND dengan wParam sama dengan SC_HOTKEY dan lParam sama dengan handel jendela. Jika pesan ini diteruskan ke DefWindowProc, sistem akan membawa popup aktif terakhir jendela (jika ada) atau jendela itu sendiri (jika tidak ada jendela popup) ke latar depan.

Jendela hanya dapat memiliki satu kunci panas. Jika jendela sudah memiliki hot key yang terkait dengannya, hot key baru menggantikan yang lama. Jika lebih dari satu jendela memiliki hot key yang sama, jendela yang diaktifkan oleh hot key acak.

Hot key ini tidak terkait dengan hot key yang ditetapkan oleh RegisterHotKey.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Kepala Halaman	Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Konseptual

Input Keyboard