Bagikan melalui

pesan WM_SETHOTKEY

  • Artikel

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

#define WM_SETHOTKEY                    0x0032

Parameter

wParam

Kata urutan rendah menentukan kode kunci virtual untuk dikaitkan dengan jendela.

Kata berurutan tinggi dapat berupa satu atau beberapa nilai berikut dari CommCtrl.h.

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

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

lParam

Parameter ini tidak digunakan.

Nilai kembali

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 ini berhasil, dan tidak ada jendela lain yang memiliki kunci panas yang sama.
2
 Fungsi ini berhasil, tetapi jendela lain sudah memiliki kunci panas yang sama.

Keterangan

Kunci panas tidak dapat dikaitkan dengan jendela anak.

VK_ESCAPE, VK_SPACE, dan VK_TAB 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 kunci panas 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]
Header
Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Konseptual

Keyboard Input