WM_APPCOMMAND pesan

  • Artikel

Memberi tahu jendela bahwa pengguna menghasilkan peristiwa perintah aplikasi, misalnya, dengan mengklik tombol perintah aplikasi menggunakan mouse atau mengetik tombol perintah aplikasi pada keyboard.

#define WM_APPCOMMAND                   0x0319

Parameter

wParam

Handel ke jendela tempat pengguna mengklik tombol atau menekan tombol. Ini bisa menjadi jendela anak dari jendela yang menerima pesan. Untuk informasi selengkapnya tentang memproses pesan ini, lihat bagian Keterangan.

lParam

Gunakan kode berikut untuk mendapatkan informasi yang terkandung dalam parameter lParam .

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Perintah aplikasi adalah cmd, yang dapat menjadi salah satu nilai berikut.

Nilai Makna
APPCOMMAND_BASS_BOOST
20
 Alihkan peningkatan bass ke aktif dan nonaktif.
APPCOMMAND_BASS_DOWN
19
 Kurangi bass.
APPCOMMAND_BASS_UP
21
 Tingkatkan bass.
APPCOMMAND_BROWSER_BACKWARD
1
 Arahkan mundur.
APPCOMMAND_BROWSER_FAVORITES
6
 Buka favorit.
APPCOMMAND_BROWSER_FORWARD
2
 Navigasi ke depan.
APPCOMMAND_BROWSER_HOME
7
 Navigasikan ke rumah.
APPCOMMAND_BROWSER_REFRESH
3
 Segarkan halaman.
APPCOMMAND_BROWSER_SEARCH
5
 Buka pencarian.
APPCOMMAND_BROWSER_STOP
4
 Hentikan pengunduhan.
APPCOMMAND_CLOSE
31
 Tutup jendela (bukan aplikasi).
APPCOMMAND_COPY
36
 Salin pilihan.
APPCOMMAND_CORRECTION_LIST
45
 Memunculkan daftar koreksi ketika kata salah diidentifikasi selama input ucapan.
APPCOMMAND_CUT
37
 Potong pilihan.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
43
 Beralih antara dua mode input ucapan: dikte dan perintah/kontrol (memberikan perintah ke aplikasi atau mengakses menu).
APPCOMMAND_FIND
28
 Buka dialog Temukan .
APPCOMMAND_FORWARD_MAIL
40
 Meneruskan pesan email.
APPCOMMAND_HELP
27
 Buka dialog Bantuan .
APPCOMMAND_LAUNCH_APP1
17
 Mulai App1.
APPCOMMAND_LAUNCH_APP2
18
 Mulai App2.
APPCOMMAND_LAUNCH_MAIL
15
 Buka email.
APPCOMMAND_LAUNCH_MEDIA_SELECT
16
 Buka mode Pilih Media.
APPCOMMAND_MEDIA_CHANNEL_DOWN
52
 Menurunkan nilai saluran, misalnya, untuk TV atau penyetel radio.
APPCOMMAND_MEDIA_CHANNEL_UP
51
 Menaikkan nilai saluran, misalnya, untuk TV atau penyetel radio.
APPCOMMAND_MEDIA_FAST_FORWARD
49
 Meningkatkan kecepatan pemutaran streaming. Ini dapat diimplementasikan dalam banyak cara, misalnya, menggunakan kecepatan tetap atau beralih melalui serangkaian kecepatan yang meningkat.
APPCOMMAND_MEDIA_NEXTTRACK
11
 Buka trek berikutnya.
APPCOMMAND_MEDIA_PAUSE
47
 Jeda. Jika sudah dijeda, jangan ambil tindakan lebih lanjut. Ini adalah perintah JEDA langsung yang tidak memiliki status. Jika ada tombol Putar dan Jeda diskrit, aplikasi harus mengambil tindakan pada perintah ini serta APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY
46
 Mulai bermain pada posisi saat ini. Jika sudah dijeda, itu akan dilanjutkan. Ini adalah perintah PLAY langsung yang tidak memiliki status. Jika ada tombol Putar dan Jeda diskrit, aplikasi harus mengambil tindakan pada perintah ini serta APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY_PAUSE
14
 Putar atau jeda pemutaran. Jika ada tombol Putar dan Jeda diskrit, aplikasi harus mengambil tindakan pada perintah ini serta APPCOMMAND_MEDIA_PLAY dan APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK
12
 Buka trek sebelumnya.
APPCOMMAND_MEDIA_RECORD
48
 Mulai merekam aliran saat ini.
APPCOMMAND_MEDIA_REWIND
50
 Mundur dalam aliran pada tingkat kecepatan yang lebih tinggi. Ini dapat diimplementasikan dalam banyak cara, misalnya, menggunakan kecepatan tetap atau beralih melalui serangkaian kecepatan yang meningkat.
APPCOMMAND_MEDIA_STOP
13
 Hentikan pemutaran.
APPCOMMAND_MIC_ON_OFF_TOGGLE
44
 Alihkan mikrofon.
APPCOMMAND_MICROPHONE_VOLUME_DOWN
25
 Kurangi volume mikrofon.
APPCOMMAND_MICROPHONE_VOLUME_MUTE
24
 Matikan suara mikrofon.
APPCOMMAND_MICROPHONE_VOLUME_UP
26
 Meningkatkan volume mikrofon.
APPCOMMAND_NEW
29
 Buat jendela baru.
APPCOMMAND_OPEN
30
 Buka jendela.
APPCOMMAND_PASTE
38
 Tempel
APPCOMMAND_PRINT
33
 Cetak dokumen saat ini.
APPCOMMAND_REDO
35
 Ulangi tindakan terakhir.
APPCOMMAND_REPLY_TO_MAIL
39
 Balas ke pesan surat.
APPCOMMAND_SAVE
32
 Simpan dokumen saat ini.
APPCOMMAND_SEND_MAIL
41
 Kirim pesan surat.
APPCOMMAND_SPELL_CHECK
42
 Memulai pemeriksaan ejaan.
APPCOMMAND_TREBLE_DOWN
22
 Kurangi treble.
APPCOMMAND_TREBLE_UP
23
 Tingkatkan treble.
APPCOMMAND_UNDO
34
 Urungkan tindakan terakhir.
APPCOMMAND_VOLUME_DOWN
9
 Turunkan volume.
APPCOMMAND_VOLUME_MUTE
8
 Matikan suara volume.
APPCOMMAND_VOLUME_UP
10
 Naikkan volume.

Komponen uDevice menunjukkan perangkat input yang menghasilkan peristiwa input, dan dapat menjadi salah satu nilai berikut.

Nilai Makna
FAPPCOMMAND_KEY
0
 Pengguna menekan tombol.
FAPPCOMMAND_MOUSE
0x8000
 Pengguna mengklik tombol mouse.
FAPPCOMMAND_OEM
0x1000
 Sumber perangkat keras yang tidak teridentifikasi menghasilkan peristiwa tersebut. Ini bisa berupa mouse atau peristiwa keyboard.

Komponen dwKeys menunjukkan apakah berbagai kunci virtual tidak berfungsi, dan bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
MK_CONTROL
0x0008
 Tombol CTRL tidak berfungsi.
MK_LBUTTON
0x0001
 Tombol kiri mouse tidak berfungsi.
MK_MBUTTON
0x0010
 Tombol mouse tengah tidak berfungsi.
MK_RBUTTON
0x0002
 Tombol kanan mouse tidak berfungsi.
MK_SHIFT
0x0004
 Tombol SHIFT tidak berfungsi.
MK_XBUTTON1
0x0020
 Tombol X pertama mati.
MK_XBUTTON2
0x0040
 Tombol X kedua tidak berfungsi.

Nilai kembali

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan TRUE. Untuk informasi selengkapnya tentang memproses nilai yang dikembalikan, lihat bagian Keterangan.

Keterangan

DefWindowProc menghasilkan pesan WM_APPCOMMAND saat memproses pesan WM_XBUTTONUP atau WM_NCXBUTTONUP , atau saat pengguna mengetik kunci perintah aplikasi.

Jika jendela anak tidak memproses pesan ini dan sebaliknya memanggil DefWindowProc, DefWindowProc akan mengirim pesan ke jendela induknya. Jika jendela tingkat atas tidak memproses pesan ini dan sebaliknya memanggil DefWindowProc, DefWindowProc akan memanggil hook shell dengan kode kait yang sama dengan HSHELL_APPCOMMAND.

Untuk mendapatkan koordinat kursor jika pesan dihasilkan oleh klik mouse, aplikasi dapat memanggil GetMessagePos. Aplikasi dapat menguji apakah pesan dihasilkan oleh mouse dengan memeriksa apakah lParam berisi FAPPCOMMAND_MOUSE.

Tidak seperti pesan windows lainnya, aplikasi harus mengembalikan TRUE dari pesan ini jika memprosesnya. Melakukannya akan memungkinkan perangkat lunak yang mensimulasikan pesan ini pada sistem Windows lebih awal dari Windows 2000 untuk menentukan apakah prosedur jendela memproses pesan atau disebut DefWindowProc untuk memprosesnya.

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

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

Konseptual

Mouse Input