WM_APPCOMMAND Nachricht
Benachrichtigt ein Fenster, dass der Benutzer ein Anwendungsbefehlsereignis generiert hat, z. B. durch Klicken auf eine Anwendungsbefehlsschaltfläche mithilfe der Maus oder Eingeben einer Anwendungsbefehlstaste auf der Tastatur.
#define WM_APPCOMMAND 0x0319
Parameter
-
wParam-
-
Ein Handle zum 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 zum Verarbeiten dieser Nachricht finden Sie im Abschnitt "Hinweise".
-
lParam-
-
Verwenden Sie den folgenden Code, um die informationen abzurufen, die im lParam Parameter enthalten sind.
cmd = GET_APPCOMMAND_LPARAM(lParam); uDevice = GET_DEVICE_LPARAM(lParam); dwKeys = GET_KEYSTATE_LPARAM(lParam);Der Anwendungsbefehl ist cmd, die einer der folgenden Werte sein kann.
Wert Bedeutung - APPCOMMAND_BASS_BOOST
- 20
Schalten Sie die Bassverstärkung ein und aus. - APPCOMMAND_BASS_DOWN
- 19
Verringern Sie den Bass. - APPCOMMAND_BASS_UP
- 21
Erhöhen Sie den Bass. - APPCOMMAND_BROWSER_BACKWARD
- 1
Rückwärts navigieren. - APPCOMMAND_BROWSER_FAVORITES
- 6
Öffnen Sie Favoriten. - APPCOMMAND_BROWSER_FORWARD
- 2
Navigieren Sie vorwärts. - APPCOMMAND_BROWSER_HOME
- 7
Navigieren Sie zu Hause. - APPCOMMAND_BROWSER_REFRESH
- 3
Seite aktualisieren. - 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
Zeigt die Korrekturliste an, wenn ein Wort während der Spracheingabe falsch identifiziert 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/Steuerelement (Befehle für eine Anwendung oder den Zugriff auf Menüs). - APPCOMMAND_FIND
- 28
Öffnen Sie das Dialogfeld "Suchen". - APPCOMMAND_FORWARD_MAIL
- 40
Weiterleiten einer E-Mail-Nachricht. - 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 E-Mails. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
Wechseln Sie zum Medienauswahlmodus. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
Erhöhen Sie den Kanalwert, z. B. für einen TV- oder Radio-Tuner. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
Erhöhen Sie den Kanalwert, z. B. für einen TV- oder Radio-Tuner. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
Erhöhen Sie die Geschwindigkeit der Streamwiedergabe. Dies kann auf vielfältige Weise implementiert werden, z. B. durch eine feste Geschwindigkeit oder durch eine Reihe von zunehmenden Geschwindigkeiten. - APPCOMMAND_MEDIA_NEXTTRACK
- 11
Zum nächsten Titel wechseln. - APPCOMMAND_MEDIA_PAUSE
- 47
Pause. Wenn sie bereits angehalten wurde, ergreifen Sie keine weiteren Maßnahmen. Dies ist ein direkter PAUSE-Befehl, der keinen Zustand aufweist. Wenn separate Schaltflächen "Wiedergeben" und "Anhalten" vorhanden sind, sollten Anwendungen aktionen für diesen Befehl sowie für APPCOMMAND_MEDIA_PLAY_PAUSEausführen. - 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 PLAY-Befehl, der keinen Zustand aufweist. Wenn es diskrete Play und Pause-Schaltflächen gibt, sollten Anwendungen aktionen für diesen Befehl sowie für APPCOMMAND_MEDIA_PLAY_PAUSEausführen. - APPCOMMAND_MEDIA_PLAY_PAUSE
- 14
Wiedergabe wiedergeben oder anhalten. Wenn diskrete Schaltflächen " wiedergeben" und " anhalten" vorhanden sind, sollten Anwendungen aktionen für diesen Befehl sowie für APPCOMMAND_MEDIA_PLAY und APPCOMMAND_MEDIA_PAUSEausführen. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
Zum vorherigen Titel wechseln. - APPCOMMAND_MEDIA_RECORD
- 48
Beginnen Sie mit der Aufzeichnung des aktuellen Datenstroms. - APPCOMMAND_MEDIA_REWIND
- 50
Fahren Sie in einem Datenstrom mit einer höheren Geschwindigkeit rückwärts. Dies kann auf vielfältige Weise implementiert werden, z. B. durch eine feste Geschwindigkeit oder durch eine Reihe von zunehmenden 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
Kleister - APPCOMMAND_PRINT
- 33
Aktuelles Dokument drucken. - APPCOMMAND_REDO
- 35
Letzte Aktion wiederholen. - APPCOMMAND_REPLY_TO_MAIL
- 39
Antworten auf eine E-Mail-Nachricht. - APPCOMMAND_SAVE
- 32
Aktuelles Dokument speichern. - APPCOMMAND_SEND_MAIL
- 41
Eine E-Mail-Nachricht senden. - APPCOMMAND_SPELL_CHECK
- 42
Initiieren einer Rechtschreibprüfung. - APPCOMMAND_TREBLE_DOWN
- 22
Verkleinern Sie den Treble. - APPCOMMAND_TREBLE_UP
- 23
Erhöhen Sie den Treble-Wert. - APPCOMMAND_UNDO
- 34
Letzte Aktion rückgängigmachen. - APPCOMMAND_VOLUME_DOWN
- 9
Verringern Sie die Lautstärke. - APPCOMMAND_VOLUME_MUTE
- 8
Schalten Sie die Lautstärke stumm. - APPCOMMAND_VOLUME_UP
- 10
Heben Sie die Lautstärke an. Die komponente uDevice gibt das Eingabegerät an, das das Eingabeereignis generiert hat, und kann einer der folgenden Werte sein.
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
Eine nicht identifizierte Hardwarequelle hat das Ereignis generiert. Es kann sich um eine Maus oder ein Tastaturereignis sein. Die dwKeys- Komponente gibt an, ob verschiedene virtuelle Schlüssel nach unten sind und eine oder mehrere der folgenden Werte sein können.
Wert Bedeutung - MK_CONTROL
- 0x0008
Die STRG-TASTE ist nach unten. - MK_LBUTTON
- 0x0001
Die linke Maustaste ist unten. - MK_MBUTTON
- 0x0010
Die mittlere Maustaste ist unten. - MK_RBUTTON
- 0x0002
Die rechte Maustaste ist unten. - MK_SHIFT
- 0x0004
Die UMSCHALTTASTE ist nach unten. - MK_XBUTTON1
- 0x0020
Die XBUTTON1 ist unten. - MK_XBUTTON2
- 0x0040
Die XBUTTON2 ist unten.
Rückgabewert
Wenn eine Anwendung diese Meldung verarbeitet, sollte sie TRUE-zurückgeben. Weitere Informationen zur Verarbeitung des Rückgabewerts finden Sie im Abschnitt "Hinweise".
Bemerkungen
DefWindowProc generiert die WM_APPCOMMAND Nachricht, wenn sie die WM_XBUTTONUP oder WM_NCXBUTTONUP Nachricht verarbeitet, oder wenn der Benutzer eine Anwendungsbefehlsschlüssel eingibt.
Wenn ein untergeordnetes Fenster diese Nachricht nicht verarbeitet und stattdessen DefWindowProc-aufruft, sendet DefWindowProc- die Nachricht an das übergeordnete Fenster. Wenn diese Meldung nicht von einem Fenster auf oberster Ebene verarbeitet wird und stattdessen DefWindowProc-aufgerufen wird, ruft DefWindowProc einen Shell-Hook mit dem Hookcode auf, der HSHELL_APPCOMMANDentspricht.
Um die Koordinaten des Cursors abzurufen, wenn die Nachricht mit einem Mausklick generiert wurde, kann die Anwendung GetMessagePosaufrufen. Eine Anwendung kann testen, ob die Nachricht von der Maus generiert wurde, indem überprüft wird, ob lParam-FAPPCOMMAND_MOUSEenthält.
Im Gegensatz zu anderen Windows-Nachrichten sollte eine Anwendung TRUE- von dieser Nachricht zurückgeben, wenn sie verarbeitet wird. Auf diese Weise können Software, die diese Meldung auf Windows-Systemen vor Windows 2000 simuliert, ermöglichen, zu bestimmen, ob die Fensterprozedur die Nachricht verarbeitet oder DefWindowProc- verarbeitet hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows 2000 Professional [nur Desktop-Apps] |
| Mindestens unterstützter Server |
Windows 2000 Server [nur Desktop-Apps] |
| Kopfball |
|
Siehe auch
-
Referenz-
-
Konzeptionelle