WM_APPCOMMAND meddelande
Meddelar ett fönster som användaren genererade en programkommandohändelse, till exempel genom att klicka på en programkommandoknapp med musen eller skriva en programkommandonyckel på tangentbordet.
#define WM_APPCOMMAND 0x0319
Parametrar
-
wParam
-
Ett handtag till fönstret där användaren klickade på knappen eller tryckte på tangenten. Det kan vara ett underordnat fönster i fönstret som tar emot meddelandet. Mer information om hur du bearbetar det här meddelandet finns i avsnittet Kommentarer.
-
lParam
-
Använd följande kod för att hämta informationen i parametern lParam.
cmd = GET_APPCOMMAND_LPARAM(lParam); uDevice = GET_DEVICE_LPARAM(lParam); dwKeys = GET_KEYSTATE_LPARAM(lParam);Programkommandot är cmd, vilket kan vara något av följande värden.
Värde Betydelse - APPCOMMAND_BASS_BOOST
- 20
Slå på och av basboosten. - APPCOMMAND_BASS_DOWN
- 19
Minska basen. - APPCOMMAND_BASS_UP
- 21
Öka basen. - APPCOMMAND_BROWSER_BACKWARD
- 1
Navigera bakåt. - APPCOMMAND_BROWSER_FAVORITES
- 6
Öppna favoriter. - APPCOMMAND_BROWSER_FORWARD
- 2
Navigera framåt. - APPCOMMAND_BROWSER_HOME
- 7
Navigera hem. - APPCOMMAND_BROWSER_REFRESH
- 3
Uppdateringssida. - APPCOMMAND_BROWSER_SEARCH
- 5
Öppna sökningen. - APPCOMMAND_BROWSER_STOP
- 4
Stoppa nedladdningen. - APPCOMMAND_CLOSE
- 31
Stäng fönstret (inte programmet). - APPCOMMAND_COPY
- 36
Kopiera markeringen. - APPCOMMAND_CORRECTION_LIST
- 45
Tar upp korrigeringslistan när ett ord identifieras felaktigt under talindata. - APPCOMMAND_CUT
- 37
Klipp ut markeringen. - APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
- 43
Växlar mellan två lägen för talinmatning: diktering och kommando/kontroll (ge kommandon till ett program eller komma åt menyer). - APPCOMMAND_FIND
- 28
Öppna dialogrutan Sök. - APPCOMMAND_FORWARD_MAIL
- 40
Vidarebefordra ett e-postmeddelande. - APPCOMMAND_HELP
- 27
Öppna dialogrutan Hjälp. - APPCOMMAND_LAUNCH_APP1
- 17
Starta App1. - APPCOMMAND_LAUNCH_APP2
- 18
Starta App2. - APPCOMMAND_LAUNCH_MAIL
- 15
Öppna e-post. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
Gå till Läget Medieval. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
Minska kanalvärdet, till exempel för en TV- eller radio tuner. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
Öka kanalvärdet, till exempel för en TV- eller radio tuner. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
Öka uppspelningshastigheten för dataströmmen. Detta kan implementeras på många sätt, till exempel genom att använda en fast hastighet eller växla genom en serie med ökande hastigheter. - APPCOMMAND_MEDIA_NEXTTRACK
- 11
Gå till nästa spår. - APPCOMMAND_MEDIA_PAUSE
- 47
Paus. Om du redan har pausat vidtar du inga ytterligare åtgärder. Det här är ett direkt PAUSE-kommando som inte har något tillstånd. Om det finns diskreta uppspelnings- och pausknappar bör program vidta åtgärder för det här kommandot samt APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY
- 46
Börja spela på den aktuella positionen. Om den redan har pausats återupptas den. Det här är ett direkt PLAY-kommando som inte har något tillstånd. Om det finns diskreta Play- och Pausa-knappar bör program vidta åtgärder för det här kommandot samt APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY_PAUSE
- 14
Spela upp eller pausa uppspelningen. Om det finns diskreta Play- och Pausa-knappar bör program vidta åtgärder för det här kommandot samt APPCOMMAND_MEDIA_PLAY och APPCOMMAND_MEDIA_PAUSE. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
Gå till föregående spår. - APPCOMMAND_MEDIA_RECORD
- 48
Börja spela in den aktuella strömmen. - APPCOMMAND_MEDIA_REWIND
- 50
Gå bakåt i en ström med en högre hastighet. Detta kan implementeras på många sätt, till exempel genom att använda en fast hastighet eller växla genom en serie med ökande hastigheter. - APPCOMMAND_MEDIA_STOP
- 13
Stoppa uppspelningen. - APPCOMMAND_MIC_ON_OFF_TOGGLE
- 44
Växla mikrofonen. - APPCOMMAND_MICROPHONE_VOLUME_DOWN
- 25
Minska mikrofonvolymen. - APPCOMMAND_MICROPHONE_VOLUME_MUTE
- 24
Stäng av mikrofonen. - APPCOMMAND_MICROPHONE_VOLUME_UP
- 26
Öka mikrofonvolymen. - APPCOMMAND_NEW
- 29
Skapa ett nytt fönster. - APPCOMMAND_OPEN
- 30
Öppna ett fönster. - APPCOMMAND_PASTE
- 38
Klistra - APPCOMMAND_PRINT
- 33
Skriv ut aktuellt dokument. - APPCOMMAND_REDO
- 35
Gör om den senaste åtgärden. - APPCOMMAND_REPLY_TO_MAIL
- 39
Svara på ett e-postmeddelande. - APPCOMMAND_SAVE
- 32
Spara aktuellt dokument. - APPCOMMAND_SEND_MAIL
- 41
Skicka ett e-postmeddelande. - APPCOMMAND_SPELL_CHECK
- 42
Starta en stavningskontroll. - APPCOMMAND_TREBLE_DOWN
- 22
Minska diskanten. - APPCOMMAND_TREBLE_UP
- 23
Öka diskanten. - APPCOMMAND_UNDO
- 34
Ångra den senaste åtgärden. - APPCOMMAND_VOLUME_DOWN
- 9
Sänk volymen. - APPCOMMAND_VOLUME_MUTE
- 8
Stäng av volymen. - APPCOMMAND_VOLUME_UP
- 10
Höj volymen. Komponenten uDevice anger den indataenhet som genererade indatahändelsen och kan vara något av följande värden.
Värde Betydelse - FAPPCOMMAND_KEY
- 0
Användaren tryckte på en nyckel. - FAPPCOMMAND_MOUSE
- 0x8000
Användaren klickade på en musknapp. - FAPPCOMMAND_OEM
- 0x1000
En oidentifierad maskinvarukälla genererade händelsen. Det kan vara en mus- eller tangentbordshändelse. Komponenten dwKeys anger om olika virtuella nycklar är nere och kan vara ett eller flera av följande värden.
Värde Betydelse - MK_CONTROL
- 0x0008
CTRL-tangenten är nere. - MK_LBUTTON
- 0x0001
Vänster musknapp är nere. - MK_MBUTTON
- 0x0010
Den mellersta musknappen är nere. - MK_RBUTTON
- 0x0002
Höger musknapp är nere. - MK_SHIFT
- 0x0004
SKIFT-nyckeln är nere. - MK_XBUTTON1
- 0x0020
XBUTTON1 är nere. - MK_XBUTTON2
- 0x0040
XBUTTON2 är nere.
Returvärde
Om ett program bearbetar det här meddelandet bör det returnera TRUE-. Mer information om hur du bearbetar returvärdet finns i avsnittet Anmärkningar.
Anmärkningar
DefWindowProc genererar det WM_APPCOMMAND meddelandet när det bearbetar meddelandet WM_XBUTTONUP eller WM_NCXBUTTONUP, eller när användaren skriver en programkommandonyckel.
Om ett underordnat fönster inte bearbetar det här meddelandet och i stället anropar DefWindowProcskickar DefWindowProc meddelandet till det överordnade fönstret. Om ett fönster på den översta nivån inte bearbetar det här meddelandet och i stället anropar DefWindowProcanropar DefWindowProc en skalkrok med krokkoden lika med HSHELL_APPCOMMAND.
Om du vill hämta koordinaterna för markören om meddelandet genererades med ett musklick kan programmet anropa GetMessagePos. Ett program kan testa om meddelandet genererades av musen genom att kontrollera om lParam innehåller FAPPCOMMAND_MOUSE.
Till skillnad från andra Windows-meddelanden bör ett program returnera TRUE- från det här meddelandet om det bearbetar det. På så sätt kan programvara som simulerar det här meddelandet i Windows-system som är tidigare än Windows 2000 avgöra om fönsterproceduren bearbetade meddelandet eller anropade DefWindowProc bearbeta det.
Krav
| Krav | Värde |
|---|---|
| Lägsta klient som stöds |
Windows 2000 Professional [endast skrivbordsappar] |
| Lägsta server som stöds |
Windows 2000 Server [endast skrivbordsappar] |
| Rubrik |
|