Bagikan melalui


WM_APPCOMMAND pesan

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