zpráva WM_APPCOMMAND

Článek
01/23/2025

Upozorní okno, že uživatel vygeneroval událost příkazu aplikace, například kliknutím na příkazové tlačítko aplikace pomocí myši nebo zadáním příkazové klávesy aplikace na klávesnici.

#define WM_APPCOMMAND                   0x0319

Parametry

wParam

Úchyt pro okno, kde uživatel klikl na tlačítko nebo stiskl klávesu. Může se jednat o podřízené okno okna, které zprávu obdrží. Další informace o zpracování této zprávy naleznete v části Poznámky.

lParam

Pomocí následujícího kódu získejte informace obsažené v parametru lParam.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Příkaz aplikace je cmd, což může být jedna z následujících hodnot.

Hodnota	Význam
APPCOMMAND_BASS_BOOST 20	Zapněte a vypněte basy.
APPCOMMAND_BASS_DOWN 19	Zmenšte basy.
APPCOMMAND_BASS_UP 21	Zvyšte basy.
APPCOMMAND_BROWSER_BACKWARD 1	Přechádět dozadu.
APPCOMMAND_BROWSER_FAVORITES 6	Otevřete oblíbené položky.
APPCOMMAND_BROWSER_FORWARD 2	Přechádět vpřed
APPCOMMAND_BROWSER_HOME 7	Přejděte domů.
APPCOMMAND_BROWSER_REFRESH 3	Aktualizovat stránku.
APPCOMMAND_BROWSER_SEARCH 5	Otevřete hledání.
APPCOMMAND_BROWSER_STOP 4	Ukončit stahování.
APPCOMMAND_CLOSE 31	Zavřete okno (ne aplikaci).
APPCOMMAND_COPY 36	Zkopírujte výběr.
APPCOMMAND_CORRECTION_LIST 45	Zobrazí seznam oprav, když je slovo nesprávně identifikováno během zadávání řeči.
APPCOMMAND_CUT 37	Vyjměte výběr.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE 43	Přepíná mezi dvěma režimy vstupu řeči: diktování a příkaz/řízení (poskytování příkazů aplikaci nebo přístup k nabídkám).
APPCOMMAND_FIND 28	Otevřete dialogové okno Najít.
APPCOMMAND_FORWARD_MAIL 40	Přeposlání e-mailové zprávy
APPCOMMAND_HELP 27	Otevřete dialogové okno nápovědy.
APPCOMMAND_LAUNCH_APP1 17	Spusťte aplikaci 1.
APPCOMMAND_LAUNCH_APP2 18	Spusťte aplikaci App2.
APPCOMMAND_LAUNCH_MAIL 15	Otevřete poštu.
APPCOMMAND_LAUNCH_MEDIA_SELECT 16	Přejděte do režimu výběru médií.
APPCOMMAND_MEDIA_CHANNEL_DOWN 52	Dekrementujte hodnotu kanálu, například pro televizní nebo rádiový tuner.
APPCOMMAND_MEDIA_CHANNEL_UP 51	Zvýší hodnotu kanálu, například pro televizní nebo rádiový tuner.
APPCOMMAND_MEDIA_FAST_FORWARD 49	Zvyšte rychlost přehrávání streamu. To je možné implementovat mnoha způsoby, například pomocí pevné rychlosti nebo přepínání řady zvyšujících se rychlostí.
APPCOMMAND_MEDIA_NEXTTRACK 11	Přejděte na další trasu.
APPCOMMAND_MEDIA_PAUSE 47	Pauza. Pokud už je pozastaveno, neprojděte žádnou další akci. Jedná se o přímý příkaz PAUSE, který nemá žádný stav. Pokud existují samostatná tlačítka Přehrát a Pozastavit, aplikace by měly s tímto příkazem provádět akce i APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY 46	Začněte hrát na aktuální pozici. Pokud už je pozastaveno, obnoví se. Jedná se o přímý příkaz PLAY, který nemá žádný stav. Pokud existují samostatná tlačítka Přehrát a Pozastavit, měly by aplikace s tímto příkazem provádět akce i APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY_PAUSE 14	Přehrávání nebo pozastavení přehrávání Pokud existují samostatná tlačítka Přehrát a Pozastavit, měly by aplikace s tímto příkazem provádět akce i APPCOMMAND_MEDIA_PLAY a APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK 12	Přejděte na předchozí trasu.
APPCOMMAND_MEDIA_RECORD 48	Začněte nahrávat aktuální stream.
APPCOMMAND_MEDIA_REWIND 50	Vraťte se v datovém proudu dozadu s vyšší rychlostí rychlosti. To je možné implementovat mnoha způsoby, například pomocí pevné rychlosti nebo přepínání řady zvyšujících se rychlostí.
APPCOMMAND_MEDIA_STOP 13	Zastavit přehrávání.
APPCOMMAND_MIC_ON_OFF_TOGGLE 44	Přepněte mikrofon.
APPCOMMAND_MICROPHONE_VOLUME_DOWN 25	Snižte hlasitost mikrofonu.
APPCOMMAND_MICROPHONE_VOLUME_MUTE 24	Ztlumte mikrofon.
APPCOMMAND_MICROPHONE_VOLUME_UP 26	Zvyšte hlasitost mikrofonu.
APPCOMMAND_NEW 29	Vytvořte nové okno.
APPCOMMAND_OPEN 30	Otevřete okno.
APPCOMMAND_PASTE 38	Pasta
APPCOMMAND_PRINT 33	Tisk aktuálního dokumentu
APPCOMMAND_REDO 35	Znovu provést poslední akci.
APPCOMMAND_REPLY_TO_MAIL 39	Odpověď na e-mailovou zprávu
APPCOMMAND_SAVE 32	Uložte aktuální dokument.
APPCOMMAND_SEND_MAIL 41	Odeslat e-mailovou zprávu
APPCOMMAND_SPELL_CHECK 42	Zahajte kontrolu pravopisu.
APPCOMMAND_TREBLE_DOWN 22	Zmenší se treble.
APPCOMMAND_TREBLE_UP 23	Zvyšte treble.
APPCOMMAND_UNDO 34	Vrátit zpět poslední akci.
APPCOMMAND_VOLUME_DOWN 9	Snižte hlasitost.
APPCOMMAND_VOLUME_MUTE 8	Ztlumte hlasitost.
APPCOMMAND_VOLUME_UP 10	Zvedněte svazek.

Komponenta uDevice označuje vstupní zařízení, které vygenerovalo vstupní událost, a může to být jedna z následujících hodnot.

Hodnota	Význam
FAPPCOMMAND_KEY 0	Uživatel stiskl klávesu.
FAPPCOMMAND_MOUSE 0x8000	Uživatel klikl na tlačítko myši.
FAPPCOMMAND_OEM 0x1000	Neidentifikovaný zdroj hardwaru vygeneroval událost. Může se jednat o událost myši nebo klávesnice.

Komponenta dwKeys označuje, jestli jsou různé virtuální klíče dole, a může to být jedna nebo více následujících hodnot.

Hodnota	Význam
MK_CONTROL 0x0008	Klávesa CTRL je dole.
MK_LBUTTON 0x0001	Levé tlačítko myši je dole.
MK_MBUTTON 0x0010	Prostřední tlačítko myši je dole.
MK_RBUTTON 0x0002	Pravé tlačítko myši je dole.
MK_SHIFT 0x0004	Klávesa SHIFT je dole.
MK_XBUTTON1 0x0020	XBUTTON1 je dole.
MK_XBUTTON2 0x0040	XBUTTON2 je dole.

Návratová hodnota

Pokud aplikace zpracuje tuto zprávu, měla by vrátit TRUE. Další informace o zpracování návratové hodnoty naleznete v části Poznámky.

Poznámky

DefWindowProc generuje zprávu WM_APPCOMMAND při zpracování WM_XBUTTONUP nebo WM_NCXBUTTONUP zprávy nebo když uživatel zadá příkazový klíč aplikace.

Pokud podřízené okno tuto zprávu nezpracuje a místo toho volá DefWindowProc, DefWindowProc odešle zprávu do nadřazeného okna. Pokud okno nejvyšší úrovně nezpracuje tuto zprávu a místo toho volá DefWindowProc, DefWindowProc zavolá hák prostředí s kódem háku, který se rovná HSHELL_APPCOMMAND.

Chcete-li získat souřadnice kurzoru, pokud byla zpráva generována kliknutím myši, aplikace může volat GetMessagePos. Aplikace může otestovat, zda zpráva byla generována myší kontrolou, zda lParam obsahuje FAPPCOMMAND_MOUSE.

Na rozdíl od jiných zpráv systému Windows by aplikace měla vrátit TRUE z této zprávy, pokud ji zpracuje. Tím umožníte softwaru, který simuluje tuto zprávu v systémech Windows starších než Windows 2000, určit, zda procedura okna zpracovávala zprávu nebo volala DefWindowProc zpracovat.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	Winuser.h (včetně Windows.h)

Viz také

referenční
DefWindowProc
GET_APPCOMMAND_LPARAM
GET_DEVICE_LPARAM
GET_KEYSTATE_LPARAM
prostředí ShellProc
WM_XBUTTONUP
WM_NCXBUTTONUP
koncepční
vstupu myši

Sdílet prostřednictvím