WM_APPCOMMAND-Nachricht
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 |
|