WM_APPCOMMAND-Nachricht

  • Artikel

Sendet eine Benachrichtigung an ein Fenster, dass Benutzer*innen ein Anwendungsbefehlsereignis generiert haben, z. B. indem sie mit der Maus auf eine Anwendungsbefehlsschaltfläche klicken oder auf der Tastatur eine Anwendungsbefehlstaste drücken.

#define WM_APPCOMMAND                   0x0319

Parameter

wParam

Ein Handle für das Fenster, in dem der Benutzer auf die Schaltfläche geklickt oder die Taste gedrückt hat. Dies kann ein untergeordnetes Fenster des Fensters sein, das die Nachricht empfängt. Weitere Informationen zur Verarbeitung dieser Nachricht finden Sie im Abschnitt „Bemerkungen“.

lParam

Verwenden Sie den folgenden Code, um die Informationen im Parameter IParam abzurufen.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Der Anwendungsbefehl ist cmd. Dies kann einer der folgenden Werte sein.

Wert Bedeutung
APPCOMMAND_BASS_BOOST
20
 Schalten Sie den Bass-Boost ein und aus.
APPCOMMAND_BASS_DOWN
19
 Verringern Sie den Bass.
APPCOMMAND_BASS_UP
21
 Erhöhen Sie den Bass.
APPCOMMAND_BROWSER_BACKWARD
1
 Navigieren Sie rückwärts.
APPCOMMAND_BROWSER_FAVORITES
6
 Öffnen Sie die Favoriten.
APPCOMMAND_BROWSER_FORWARD
2
 Navigieren Sie vorwärts.
APPCOMMAND_BROWSER_HOME
7
 Navigieren Sie zum Start.
APPCOMMAND_BROWSER_REFRESH
3
 Aktualisieren Sie die Seite.
APPCOMMAND_BROWSER_SEARCH
5
 Öffnen Sie die Suche.
APPCOMMAND_BROWSER_STOP
4
 Beenden Sie den Download.
APPCOMMAND_CLOSE
31
 Schließen Sie das Fenster (nicht die Anwendung).
APPCOMMAND_COPY
36
 Kopieren Sie die Auswahl.
APPCOMMAND_CORRECTION_LIST
45
 Ruft die Korrekturliste auf, wenn ein Wort bei der Spracheingabe falsch erkannt wird.
APPCOMMAND_CUT
37
 Schneiden Sie die Auswahl aus.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
43
 Schaltet zwischen zwei Modi der Spracheingabe um: Diktieren und Befehl/Steuerung (Befehle für eine Anwendung oder den Zugriff auf Menüs).
APPCOMMAND_FIND
28
 Öffnen Sie das Dialogfeld Suchen.
APPCOMMAND_FORWARD_MAIL
40
 Leiten Sie eine E-Mail-Nachricht weiter.
APPCOMMAND_HELP
27
 Öffnen Sie das Dialogfeld Hilfe.
APPCOMMAND_LAUNCH_APP1
17
 Starten Sie App1.
APPCOMMAND_LAUNCH_APP2
18
 Starten Sie App2.
APPCOMMAND_LAUNCH_MAIL
15
 Öffnen Sie die E-Mails.
APPCOMMAND_LAUNCH_MEDIA_SELECT
16
 Wechseln Sie zum Medienauswahlmodus.
APPCOMMAND_MEDIA_CHANNEL_DOWN
52
 Verringern Sie den Kanalwert, z. B. für einen TV- oder Radiotuner.
APPCOMMAND_MEDIA_CHANNEL_UP
51
 Erhöhen Sie den Kanalwert, z. B. für einen TV- oder Radiotuner.
APPCOMMAND_MEDIA_FAST_FORWARD
49
 Erhöhen Sie die Geschwindigkeit der Streamwiedergabe. Dies kann auf viele Arten implementiert werden, z. B. durch eine feste Geschwindigkeit oder das Umschalten durch eine Reihe von steigenden Geschwindigkeiten.
APPCOMMAND_MEDIA_NEXTTRACK
11
 Wechseln Sie zum nächsten Titel.
APPCOMMAND_MEDIA_PAUSE
47
 Anhalten. Wenn sie bereits angehalten wurde, führen Sie keine weiteren Maßnahmen aus. Dies ist ein direkter PAUSE-Befehl ohne Status. Wenn separate Wiedergabe- und Pausentasten vorhanden sind, sollten Anwendungen sowohl für diesen Befehl als auch für APPCOMMAND_MEDIA_PLAY_PAUSE Maßnahmen ergreifen.
APPCOMMAND_MEDIA_PLAY
46
 Beginnen Sie mit der Wiedergabe an der aktuellen Position. Wenn sie bereits angehalten wurde, wird sie fortgesetzt. Dies ist ein direkter WIEDERGABE-Befehl ohne Status. Wenn separate Wiedergabe- und Pause-Tasten vorhanden sind, sollten Anwendungen sowohl für diesen Befehl als auch für APPCOMMAND_MEDIA_PLAY_PAUSE Maßnahmen ergreifen.
APPCOMMAND_MEDIA_PLAY_PAUSE
14
 Wiedergabe oder Anhalten der Wiedergabe. Wenn separate Wiedergabe- und Pause-Tasten vorhanden sind, sollten Anwendungen sowohl für diesen Befehl als auch für APPCOMMAND_MEDIA_PLAY und APPCOMMAND_MEDIA_PAUSE Maßnahmen ergreifen.
APPCOMMAND_MEDIA_PREVIOUSTRACK
12
 Wechseln Sie zum vorherigen Frame.
APPCOMMAND_MEDIA_RECORD
48
 Beginnen Sie mit der Aufzeichnung des aktuellen Streams.
APPCOMMAND_MEDIA_REWIND
50
 Gehen Sie in einem Stream mit höherer Geschwindigkeit rückwärts. Dies kann auf viele Arten implementiert werden, z. B. durch eine feste Geschwindigkeit oder das Umschalten durch eine Reihe von steigenden Geschwindigkeiten.
APPCOMMAND_MEDIA_STOP
13
 Beenden Sie die Wiedergabe.
APPCOMMAND_MIC_ON_OFF_TOGGLE
44
 Schalten Sie das Mikrofon um.
APPCOMMAND_MICROPHONE_VOLUME_DOWN
25
 Verringern Sie die Mikrofonlautstärke.
APPCOMMAND_MICROPHONE_VOLUME_MUTE
24
 Schalten Sie das Mikrofon stumm.
APPCOMMAND_MICROPHONE_VOLUME_UP
26
 Erhöhen Sie die Mikrofonlautstärke.
APPCOMMAND_NEW
29
 Erstellen Sie ein neues Fenster.
APPCOMMAND_OPEN
30
 Öffnen Sie ein Fenster.
APPCOMMAND_PASTE
38
 Einfügen
APPCOMMAND_PRINT
33
 Drucken Sie das aktuelle Dokument.
APPCOMMAND_REDO
35
 Wiederholen Sie die letzte Aktion.
APPCOMMAND_REPLY_TO_MAIL
39
 Antworten Sie auf eine E-Mail-Nachricht.
APPCOMMAND_SAVE
32
 Speichern Sie das aktuelle Dokument.
APPCOMMAND_SEND_MAIL
41
 Senden Sie eine E-Mail-Nachricht.
APPCOMMAND_SPELL_CHECK
42
 Initiieren Sie eine Rechtschreibprüfung.
APPCOMMAND_TREBLE_DOWN
22
 Verringern Sie die Höhen.
APPCOMMAND_TREBLE_UP
23
 Erhöhen Sie die Höhen.
APPCOMMAND_UNDO
34
 Machen Sie die letzte Aktion rückgängig.
APPCOMMAND_VOLUME_DOWN
9
 Verringern Sie die Lautstärke.
APPCOMMAND_VOLUME_MUTE
8
 Schalten Sie die Lautstärke stumm.
APPCOMMAND_VOLUME_UP
10
 Erhöhen Sie die Lautstärke.

Die uDevice-Komponente gibt das Eingabegerät an, mit dem das Eingabeereignis generiert wurde. Dabei kann es sich um einen der folgenden Werte handeln.

Wert Bedeutung
FAPPCOMMAND_KEY
0
 Der Benutzer hat eine Taste gedrückt.
FAPPCOMMAND_MOUSE
0x8000
 Der Benutzer hat auf eine Maustaste geklickt.
FAPPCOMMAND_OEM
0x1000
 Das Ereignis wurde von einer nicht identifizierten Hardwarequelle generiert. Es kann sich um ein Maus- oder ein Tastaturereignis handelt.

Mit der dwKeys-Komponente wird angegeben, ob verschiedene virtuelle Tasten gedrückt sind; dabei kann es sich um mindestens einen der folgenden Werte handeln.

Wert Bedeutung
MK_CONTROL
0x0008
 Die STRG-TASTE ist gedrückt.
MK_LBUTTON
0x0001
 Die linke Maustaste ist gedrückt.
MK_MBUTTON
0x0010
 Die mittlere Maustaste ist gedrückt.
MK_RBUTTON
0x0002
 Die rechte Maustaste ist gedrückt.
MK_SHIFT
0x0004
 Die UMSCHALT-Taste ist gedrückt.
MK_XBUTTON1
0x0020
 Die erste X-Taste ist gedrückt.
MK_XBUTTON2
0x0040
 Die zweite X-Taste ist gedrückt.

Rückgabewert

Wenn eine Anwendung diese Meldung verarbeitet, sollte TRUE zurückgegeben werden. Weitere Informationen zur Verarbeitung des Rückgabewerts finden Sie im Abschnitt „Bemerkungen“.

Bemerkungen

DefWindowProc generiert die WM_APPCOMMAND-Nachricht, wenn die WM_XBUTTONUP- oder die WM_NCXBUTTONUP-Nachricht verarbeitet wird oder wenn der Benutzer einen Anwendungsbefehl eingibt.

Wenn ein untergeordnetes Fenster diese Nachricht nicht verarbeitet und stattdessen DefWindowProc aufruft, sendet DefWindowProc die Nachricht an das übergeordnete Fenster. Wenn ein Fenster der obersten Ebene diese Nachricht nicht verarbeitet und stattdessen DefWindowProc aufruft, ruft DefWindowProc einen Shell-Hook auf, dessen Hookcode HSHELL_APPCOMMAND entspricht.

Um die Koordinaten des Cursors abzurufen, wenn die Nachricht mit einem Mausklick generiert wurde, kann die Anwendung GetMessagePos aufrufen. Eine Anwendung kann testen, ob die Nachricht mit der Maus generiert wurde, indem sie überprüft, ob lParamFAPPCOMMAND_MOUSE enthält.

Im Gegensatz zu anderen Windows-Nachrichten sollte eine Anwendung zu dieser Nachricht TRUE zurückgeben, wenn sie sie verarbeitet. Dadurch kann Software, die diese Meldung auf Windows-Systemen vor Windows 2000 simuliert, bestimmen, ob die Fensterprozedur die Meldung verarbeitet oder DefWindowProc für die Verarbeitung aufgerufen hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]
Header
Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

Konzept

Mauseingabe