WM _ APPCOMMAND-Nachricht

Benachrichtigt ein Fenster, dass der Benutzer ein Anwendungsbefehlsereignis generiert hat, z. B. indem er mit der Maus auf eine Anwendungsbefehlsschaltfläche klickt oder eine Anwendungsbefehlstaste auf der Tastatur eingibt.

#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 zum Verarbeiten dieser Nachricht finden Sie im Abschnitt "Hinweise".

lParam

Verwenden Sie den folgenden Code, um die im lParam-Parameter enthaltenen Informationen 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 _ BOOST _
20
Schalten Sie den Verstärkungston ein und aus.
APPCOMMAND _ DROPDOWN _
19
Verringern Sie den 16-Prozent-80-Prozent
APPCOMMAND _ POPUP _ 21
Erhöhen Sie den Vergrößerungston.
APPCOMMAND _ BROWSER _ RÜCKWÄRTS
1
Navigieren Sie rückwärts.
APPCOMMAND _ _BROWSERFAVORITEN
6
Öffnen Sie Favoriten.
APPCOMMAND _ BROWSER _ FORWARD
2
Navigieren Sie vorwärts.
APPCOMMAND _ BROWSER _ HOME
7
Navigieren Sie zur Startseite.
APPCOMMAND _ _BROWSERAKTUALISIERUNG
3
Seite "Aktualisieren".
APPCOMMAND _ _BROWSERSUCHE
5
Öffnen Sie die Suche.
APPCOMMAND _ _BROWSERSTOPP
4
Beenden Sie den Download.
APPCOMMAND _ CLOSE
31
Schließen Sie das Fenster (nicht die Anwendung).
APPCOMMAND _ COPY
36
Kopieren Sie die Auswahl.
APPCOMMAND _ _KORREKTURLISTE
45
Ruft die Korrekturliste auf, wenn ein Wort während der Spracheingabe falsch identifiziert wird.
APPCOMMAND _ CUT
37
Schneiden Sie die Auswahl aus.
APPCOMMAND _ DIKTIEREN _ ODER _ _ BEFEHLSSTEUERUNG _ UMSCHALTEN
43
Schaltet zwischen zwei Modi der Spracheingabe um: Diktat und Befehl/Steuerung (Befehle an eine Anwendung geben oder auf Menüs zugreifen).
APPCOMMAND _ FIND
28
Öffnen Sie das Dialogfeld Suchen.
APPCOMMAND _ WEITERLEITEN _ VON E-MAIL
40
Weiterleiten einer E-Mail-Nachricht.
APPCOMMAND _ HILFE
27
Öffnen Sie das Dialogfeld Hilfe.
APPCOMMAND _ STARTEN VON _ APP1
17
Starten Sie App1.
APPCOMMAND _ STARTEN VON _ APP2
18
Starten Sie App2.
APPCOMMAND _ STARTEN VON _ MAIL
15
Öffnen Sie die E-Mail.
APPCOMMAND _ LAUNCH _ MEDIA _ SELECT
16
Wechseln Sie zum Medienauswahlmodus.
APPCOMMAND _ MEDIA _ CHANNEL _ DOWN
52
Dekrementierung des Kanalwerts, 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 viele verschiedene Arten implementiert werden, z. B. mit einer festen Geschwindigkeit oder durch eine Reihe steigender Geschwindigkeiten.
APPCOMMAND _ MEDIA _ NEXTTRACK
11
Wechseln Sie zur nächsten Spur.
APPCOMMAND _ MEDIA _ PAUSE
47
Anhalten. Wenn sie bereits angehalten wurde, können Sie keine weiteren Maßnahmen ergreifen. Dies ist ein direkter PAUSE-Befehl ohne Status. Wenn diskrete Wiedergabe- und Pausenschaltflächen vorhanden sind, sollten Anwendungen aktionen für diesen Befehl sowie APPCOMMAND _ MEDIA PLAY PAUSE _ _ ausfü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 ohne Status. Wenn diskrete Wiedergabe- und Pausenschaltflächen vorhanden sind, sollten Anwendungen aktionen für diesen Befehl sowie APPCOMMAND _ MEDIA PLAY PAUSE _ _ ausführen.
APPCOMMAND _ MEDIA _ PLAY _ PAUSE
14
Wiedergabe wiedergeben oder anhalten. Wenn diskrete Wiedergabe- und Pausenschaltflächen vorhanden sind, sollten Anwendungen aktionen für diesen Befehl sowie APPCOMMAND _ MEDIA _ PLAY und APPCOMMAND _ MEDIA PAUSE _ ausführen.
APPCOMMAND _ MEDIA _ PREVIOUSTRACK
12
Wechseln Sie zur vorherigen Spur.
APPCOMMAND _ MEDIA _ RECORD
48
Beginnen Sie mit der Aufzeichnung des aktuellen Streams.
APPCOMMAND _ MEDIA _ REWIND
50
Wechseln Sie in einem Stream mit einer höheren Geschwindigkeit rückwärts. Dies kann auf viele verschiedene Arten implementiert werden, z. B. mit einer festen Geschwindigkeit oder durch eine Reihe steigender Geschwindigkeiten.
APPCOMMAND _ _MEDIENSTOPP
13
Beenden Sie die Wiedergabe.
APPCOMMAND _ MIC _ ON _ OFF _ TOGGLE
44
Schalten Sie das Mikrofon um.
APPCOMMAND _ MIKROFONVOLUMEN _ _ NACH UNTEN
25
Verringern Sie die Mikrofonlautstärke.
APPCOMMAND _ _ _ MIKROFONLAUTSTÄRKE
24
Stummschalten des Mikrofons.
APPCOMMAND _ _ _ MIKROFONLAUTSTÄRKE BIS
26
Erhöhen Sie die Mikrofonlautstärke.
APPCOMMAND _ NEU
29
Erstellen Sie ein neues Fenster.
APPCOMMAND _ OPEN
30
Öffnen Sie ein Fenster.
APPCOMMAND _ EINFÜGEN
38
Einfügen
APPCOMMAND _ PRINT
33
Aktuelles Dokument drucken.
APPCOMMAND _ REDO
35
Letzte Aktion wiederholen.
APPCOMMAND _ ANTWORT _ AUF _ E-MAIL
39
Antwort auf eine E-Mail-Nachricht.
APPCOMMAND _ SAVE
32
Speichern Sie das aktuelle Dokument.
APPCOMMAND _ SEND _ MAIL
41
Senden einer E-Mail-Nachricht.
APPCOMMAND _ _RECHTSCHREIBPRÜFUNG
42
Initiieren Sie eine Rechtschreibprüfung.
APPCOMMAND _ TREBLE _ DOWN
22
Verringern Sie die Verdreifachung.
APPCOMMAND _ TREBLE _ UP
23
Erhöhen Sie den Treble.
APPCOMMAND _ UNDO
34
Rückgängig der letzten Aktion.
APPCOMMAND _ VOLUME _ DOWN
9
Verringern Sie das Volume.
APPCOMMAND _ VOLUME _ MUTE
8
Stummschalten des Volumes.
APPCOMMAND _ VOLUME _ UP
10
Heben Sie das Volume auf.

Die uDevice-Komponente 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. Dies kann eine Maus oder ein Tastaturereignis sein.

Die dwKeys-Komponente gibt an, ob verschiedene virtuelle Schlüssel ausfallen und einer oder mehrere der folgenden Werte sein können.

Wert Bedeutung
MK _ CONTROL
0x0008
Die STRG-TASTE ist gedrückt.
MK _ LBUTTON
0x0001
Die linke Maustaste ist nach unten geschaltet.
MK _ MBUTTON
0x0010
Die mittlere Maustaste ist gedrückt.
MK _ RBUTTON
0x0002
Die rechte Maustaste ist nach unten geschaltet.
MK _ SHIFT
0x0004
Die UMSCHALTTASTE ist nicht mehr gedrückt.
MK _ XBUTTON1
0x0020
Die erste X-Schaltfläche ist ausgeschaltet.
MK _ XBUTTON2-0x0040
Die zweite X-Schaltfläche ist nicht mehr angezeigt.

Rückgabewert

Wenn eine Anwendung diese Nachricht 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 die WM _ XBUTTONUP- oder WM _ NCXBUTTONUP-Nachricht verarbeitet wird oder wenn der Benutzer einen Anwendungsbefehlsschlüssel eingibt.

Wenn ein untergeordnetes Fenster diese Nachricht nicht verarbeitet und stattdessen DefWindowProcaufruft, sendet DefWindowProc die Nachricht an das übergeordnete Fenster. Wenn ein Fenster der obersten Ebene diese Meldung nicht verarbeitet und stattdessen DefWindowProc aufruft, ruft DefWindowProc einen Shellhook mit dem Hookcode auf, der HSHELL _ APPCOMMAND entspricht.

Um die Koordinaten des Cursors abzurufen, wenn die Nachricht durch einen Mausklick generiert wurde, kann die Anwendung GetMessagePosaufrufen. Eine Anwendung kann testen, ob die Nachricht mit der Maus generiert wurde, indem überprüft wird, ob lParam FAPPCOMMAND _ MOUSE enthält.

Im Gegensatz zu anderen Windows-Nachrichten sollte eine Anwendung TRUE von dieser Nachricht zurückgeben, wenn sie sie verarbeitet. Auf diese Weise kann Software, die diese Nachricht auf Windows Systemen vor Windows 2000 simuliert, bestimmen, ob die Fensterprozedur die Nachricht verarbeitet oder DefWindowProc aufgerufen hat, um sie zu verarbeiten.

Requirements (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 (include Windows.h)

Weitere Informationen

Verweis

DefWindowProc

GET _ APPCOMMAND _ LPARAM

ABRUFEN _ DER _ GERÄTE-LPARAM

GET _ KEYSTATE _ LPARAM

ShellProc

WM _ XBUTTONUP

WM _ NCXBUTTONUP

Konzept

Mauseingabe