WM_APPCOMMAND üzenet

Értesítést küld arról, hogy a felhasználó létrehozott egy alkalmazásparancs-eseményt, például egy alkalmazásparancs gombra kattintva az egérrel, vagy begépel egy alkalmazásparancskulcsot a billentyűzeten.

#define WM_APPCOMMAND                   0x0319

Paraméterek

wParam

Egy fogópont arra az ablakra, ahol a felhasználó a gombra kattintott, vagy lenyomta a kulcsot. Ez lehet az üzenet fogadó ablakának gyermekablaka. Az üzenet feldolgozásával kapcsolatos további információkért lásd a Megjegyzések szakaszt.

lParam

Az alábbi kóddal lekérheti az lParam paraméterben található információkat.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Az alkalmazásparancs cmd, amely az alábbi értékek egyike lehet.

Érték	Jelentés
APPCOMMAND_BASS_BOOST 20	Kapcsolja be és ki a basszust.
APPCOMMAND_BASS_DOWN 19	Csökkentse a basszust.
APPCOMMAND_BASS_UP 21	Növelje a basszust.
APPCOMMAND_BROWSER_BACKWARD 1	Navigálás hátrafelé.
APPCOMMAND_BROWSER_FAVORITES 6	Nyissa meg a kedvenceket.
APPCOMMAND_BROWSER_FORWARD 2	Navigálás előre.
APPCOMMAND_BROWSER_HOME 7	Navigáljon haza.
APPCOMMAND_BROWSER_REFRESH 3	Oldal frissítése.
APPCOMMAND_BROWSER_SEARCH 5	Nyissa meg a keresést.
APPCOMMAND_BROWSER_STOP 4	Állítsa le a letöltést.
APPCOMMAND_CLOSE 31	Zárja be az ablakot (nem az alkalmazást).
APPCOMMAND_COPY 36	Másolja ki a kijelölést.
APPCOMMAND_CORRECTION_LIST 45	Megjeleníti a javítási listát, ha egy szó helytelenül van azonosítva a beszédbemenet során.
APPCOMMAND_CUT 37	Vágja ki a kijelölést.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE 43	Váltás a beszédbemenet két módja között: diktálás és parancs/vezérlés (parancsok átadása egy alkalmazásnak vagy a menük elérése).
APPCOMMAND_FIND 28	Nyissa meg a Keresés párbeszédpanelt.
APPCOMMAND_FORWARD_MAIL 40	E-mail továbbítása.
APPCOMMAND_HELP 27	Nyissa meg a Súgó párbeszédpanelt.
APPCOMMAND_LAUNCH_APP1 17	Indítsa el az App1 alkalmazást.
APPCOMMAND_LAUNCH_APP2 18	Indítsa el az App2 alkalmazást.
APPCOMMAND_LAUNCH_MAIL 15	Nyissa meg a leveleket.
APPCOMMAND_LAUNCH_MEDIA_SELECT 16	Lépjen a Médiaválasztás módra.
APPCOMMAND_MEDIA_CHANNEL_DOWN 52	A csatorna értékének megcselekedése, például egy tv- vagy rádióhangoló esetében.
APPCOMMAND_MEDIA_CHANNEL_UP 51	Növelje a csatorna értékét, például egy tv- vagy rádióhangoló esetében.
APPCOMMAND_MEDIA_FAST_FORWARD 49	Növelje a streamlejátszás sebességét. Ez sokféleképpen implementálható, például rögzített sebesség használatával vagy növekvő sebességek sorozatán keresztüli összesítéssel.
APPCOMMAND_MEDIA_NEXTTRACK 11	Ugrás a következő számra.
APPCOMMAND_MEDIA_PAUSE 47	Szünet. Ha már fel van függesztve, ne tegyen további műveletet. Ez egy közvetlen SZÜNET parancs, amelynek nincs állapota. Ha különálló Lejátszás és szüneteltetés gomb van, az alkalmazásoknak ezen a parancson és APPCOMMAND_MEDIA_PLAY_PAUSEkell elvégezniük a műveletet.
APPCOMMAND_MEDIA_PLAY 46	Kezdjen el játszani az aktuális pozícióban. Ha már fel van függesztve, az folytatódik. Ez egy közvetlen PLAY-parancs, amelynek nincs állapota. Ha különálló Lejátszás és Szüneteltetés gombokkal, az alkalmazásoknak ezen a parancson és APPCOMMAND_MEDIA_PLAY_PAUSEkell műveletet elvégezniük.
APPCOMMAND_MEDIA_PLAY_PAUSE 14	Lejátszás lejátszása vagy szüneteltetése. Ha különálló Lejátszási és Szünetelteti gombokat, az alkalmazásoknak ezen a parancson kell műveletet elvégezniük, valamint APPCOMMAND_MEDIA_PLAY és APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK 12	Ugrás az előző számra.
APPCOMMAND_MEDIA_RECORD 48	Kezdje el rögzíteni az aktuális streamet.
APPCOMMAND_MEDIA_REWIND 50	Nagyobb sebességgel térjen vissza egy streambe. Ez sokféleképpen implementálható, például rögzített sebesség használatával vagy növekvő sebességek sorozatán keresztüli összesítéssel.
APPCOMMAND_MEDIA_STOP 13	Állítsa le a lejátszást.
APPCOMMAND_MIC_ON_OFF_TOGGLE 44	Kapcsolja be a mikrofont.
APPCOMMAND_MICROPHONE_VOLUME_DOWN 25	Csökkentse a mikrofon hangerejét.
APPCOMMAND_MICROPHONE_VOLUME_MUTE 24	Némítsa el a mikrofont.
APPCOMMAND_MICROPHONE_VOLUME_UP 26	Növelje a mikrofon hangerejét.
APPCOMMAND_NEW 29	Hozzon létre egy új ablakot.
APPCOMMAND_OPEN 30	Nyisson meg egy ablakot.
APPCOMMAND_PASTE 38	Paszta
APPCOMMAND_PRINT 33	Aktuális dokumentum nyomtatása.
APPCOMMAND_REDO 35	Az utolsó művelet végrehajtása.
APPCOMMAND_REPLY_TO_MAIL 39	Válasz e-mailre.
APPCOMMAND_SAVE 32	Mentse az aktuális dokumentumot.
APPCOMMAND_SEND_MAIL 41	Küldjön e-mailt.
APPCOMMAND_SPELL_CHECK 42	Helyesírás-ellenőrzés kezdeményezése.
APPCOMMAND_TREBLE_DOWN 22	Csökkentse a triplát.
APPCOMMAND_TREBLE_UP 23	Növelje a triplát.
APPCOMMAND_UNDO 34	Utolsó művelet visszavonása.
APPCOMMAND_VOLUME_DOWN 9	Csökkentse a hangerőt.
APPCOMMAND_VOLUME_MUTE 8	A kötet elnémítása.
APPCOMMAND_VOLUME_UP 10	Emelje fel a kötetet.

Az uDevice összetevő azt a bemeneti eszközt jelzi, amely a bemeneti eseményt generálta, és az alábbi értékek egyike lehet.

Érték	Jelentés
FAPPCOMMAND_KEY 0	A felhasználó lenyomott egy kulcsot.
FAPPCOMMAND_MOUSE 0x8000	A felhasználó egy egérgombra kattintott.
FAPPCOMMAND_OEM 0x1000	Egy azonosítatlan hardverforrás generálta az eseményt. Ez lehet egér vagy billentyűzetesemény.

A dwKeys összetevő azt jelzi, hogy a különböző virtuális kulcsok leállnak-e, és az alábbi értékek közül egy vagy több lehet.

Érték	Jelentés
MK_CONTROL 0x0008	A CTRL billentyű le van omlva.
MK_LBUTTON 0x0001	A bal egérgomb le van gombra kattintva.
MK_MBUTTON 0x0010	A középső egérgomb le van va.
MK_RBUTTON 0x0002	A jobb egérgomb le van omlva.
MK_SHIFT 0x0004	A SHIFT billentyű le van omlva.
MK_XBUTTON1 0x0020	A XBUTTON1 leállt.
MK_XBUTTON2 0x0040	A XBUTTON2 leállt.

Visszaadott érték

Ha egy alkalmazás feldolgozza ezt az üzenetet, TRUEértéket kell visszaadnia. A visszatérési érték feldolgozásával kapcsolatos további információkért lásd a Megjegyzések szakaszt.

Megjegyzések

DefWindowProc létrehozza a WM_APPCOMMAND üzenetet, amikor feldolgozza a WM_XBUTTONUP vagy WM_NCXBUTTONUP üzenetet, vagy amikor a felhasználó beszed egy alkalmazásparancskulcsot.

Ha egy gyermekablak nem dolgozza fel ezt az üzenetet, és ehelyett meghívja DefWindowProc, DefWindowProc elküldi az üzenetet a szülőablakának. Ha egy felső szintű ablak nem dolgozza fel ezt az üzenetet, és ehelyett meghívja DefWindowProc, DefWindowProc meghív egy HSHELL_APPCOMMAND-nek megfelelő horogot.

A kurzor koordinátáinak lekéréséhez, ha az üzenet egy kattintással jött létre, az alkalmazás meghívhatja GetMessagePos. Az alkalmazás tesztelheti, hogy az üzenetet az egér hozta-e létre, ha ellenőrzi, hogy lParam tartalmaz-e FAPPCOMMAND_MOUSE.

A többi windowsos üzenettől eltérően az alkalmazásnak TRUE kell visszaadnia, ha feldolgozza. Ezzel lehetővé teszi, hogy a Windows 2000-nél korábbi Windows rendszereken az üzenetet szimuláló szoftverek megállapíthassák, hogy az ablak eljárás feldolgozta-e az üzenetet, vagy DefWindowProc meghívta a feldolgozásra.

Követelmények

Lásd még:

referencia

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

fogalmi

egérbemeneti