WM_APPCOMMAND bericht
Hiermee wordt een venster aangegeven dat de gebruiker bijvoorbeeld een gebeurtenis voor een toepassingsopdracht heeft gegenereerd door met de muis op een opdrachtknop van een toepassing te klikken of een opdrachttoets voor de toepassing op het toetsenbord te typen.
#define WM_APPCOMMAND 0x0319
Parameters
-
wParam-
-
Een ingang naar het venster waarin de gebruiker op de knop heeft geklikt of op de toets heeft gedrukt. Dit kan een onderliggend venster zijn van het venster dat het bericht ontvangt. Zie de sectie Opmerkingen voor meer informatie over het verwerken van dit bericht.
-
lParam-
-
Gebruik de volgende code om de informatie op te halen die is opgenomen in de parameter lParam.
cmd = GET_APPCOMMAND_LPARAM(lParam); uDevice = GET_DEVICE_LPARAM(lParam); dwKeys = GET_KEYSTATE_LPARAM(lParam);De opdracht van de toepassing is cmd, die een van de volgende waarden kan zijn.
Waarde Betekenis - APPCOMMAND_BASS_BOOST
- 20
Zet de bas boost aan en uit. - APPCOMMAND_BASS_DOWN
- 19
Verlaag de bas. - APPCOMMAND_BASS_UP
- 21
Verhoog de bas. - APPCOMMAND_BROWSER_BACKWARD
- 1
Ga achteruit. - APPCOMMAND_BROWSER_FAVORITES
- 6
Open favorieten. - APPCOMMAND_BROWSER_FORWARD
- 2
Navigeer naar voren. - APPCOMMAND_BROWSER_HOME
- 7
Ga naar huis. - APPCOMMAND_BROWSER_REFRESH
- 3
Pagina vernieuwen. - APPCOMMAND_BROWSER_SEARCH
- 5
Zoekactie openen. - APPCOMMAND_BROWSER_STOP
- 4
Stop het downloaden. - APPCOMMAND_CLOSE
- 31
Sluit het venster (niet de toepassing). - APPCOMMAND_COPY
- 36
Kopieer de selectie. - APPCOMMAND_CORRECTION_LIST
- 45
Hiermee wordt de correctielijst weergegeven wanneer een woord onjuist wordt geïdentificeerd tijdens spraakinvoer. - APPCOMMAND_CUT
- 37
De selectie knippen. - APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
- 43
Schakelen tussen twee spraakmodi: dicteren en opdracht/beheer (opdrachten geven aan een toepassing of menu's openen). - APPCOMMAND_FIND
- 28
Open het dialoogvenster Zoeken. - APPCOMMAND_FORWARD_MAIL
- 40
Een e-mailbericht doorsturen. - APPCOMMAND_HELP
- 27
Open het dialoogvenster Help-. - APPCOMMAND_LAUNCH_APP1
- 17
Start App1. - APPCOMMAND_LAUNCH_APP2
- 18
Start App2. - APPCOMMAND_LAUNCH_MAIL
- 15
Open e-mail. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
Ga naar de modus Media selecteren. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
De waarde van het kanaal verlagen, bijvoorbeeld voor een tv of radiotuner. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
Verhoog de waarde van het kanaal, bijvoorbeeld voor een tv of radiotuner. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
Verhoog de snelheid van het afspelen van stromen. Dit kan op veel manieren worden geïmplementeerd, bijvoorbeeld met behulp van een vaste snelheid of door een reeks toenemende snelheden schakelen. - APPCOMMAND_MEDIA_NEXTTRACK
- 11
Ga naar het volgende spoor. - APPCOMMAND_MEDIA_PAUSE
- 47
Pauzeren. Als deze al is onderbroken, voert u geen verdere actie uit. Dit is een directe PAUSE-opdracht die geen status heeft. Als er discrete knoppen Afspelen en Onderbreken zijn, moeten toepassingen actie ondernemen op deze opdracht en APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY
- 46
Begin met spelen op de huidige positie. Als deze al is onderbroken, wordt deze hervat. Dit is een directe PLAY-opdracht die geen status heeft. Als er discrete afspelen en knoppen onderbreken, moeten toepassingen actie ondernemen op deze opdracht en APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY_PAUSE
- 14
Afspelen afspelen of onderbreken. Als er discrete afspelen en knoppen onderbreken, moeten toepassingen actie ondernemen op deze opdracht, evenals APPCOMMAND_MEDIA_PLAY en APPCOMMAND_MEDIA_PAUSE. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
Ga naar het vorige nummer. - APPCOMMAND_MEDIA_RECORD
- 48
Begin met het opnemen van de huidige stream. - APPCOMMAND_MEDIA_REWIND
- 50
Ga achteruit in een stroom met een hogere snelheid. Dit kan op veel manieren worden geïmplementeerd, bijvoorbeeld met behulp van een vaste snelheid of door een reeks toenemende snelheden schakelen. - APPCOMMAND_MEDIA_STOP
- 13
Stoppen met afspelen. - APPCOMMAND_MIC_ON_OFF_TOGGLE
- 44
Schakel de microfoon in. - APPCOMMAND_MICROPHONE_VOLUME_DOWN
- 25
Verlaag het microfoonvolume. - APPCOMMAND_MICROPHONE_VOLUME_MUTE
- 24
De microfoon dempen. - APPCOMMAND_MICROPHONE_VOLUME_UP
- 26
Vergroot het microfoonvolume. - APPCOMMAND_NEW
- 29
Maak een nieuw venster. - APPCOMMAND_OPEN
- 30
Open een venster. - APPCOMMAND_PASTE
- 38
Plakken - APPCOMMAND_PRINT
- 33
Huidig document afdrukken. - APPCOMMAND_REDO
- 35
Laatste bewerking opnieuw uitvoeren. - APPCOMMAND_REPLY_TO_MAIL
- 39
Een e-mailbericht beantwoorden. - APPCOMMAND_SAVE
- 32
Sla het huidige document op. - APPCOMMAND_SEND_MAIL
- 41
Een e-mailbericht verzenden. - APPCOMMAND_SPELL_CHECK
- 42
Start een spellingcontrole. - APPCOMMAND_TREBLE_DOWN
- 22
Verlaag de treble. - APPCOMMAND_TREBLE_UP
- 23
Verhoog de treble. - APPCOMMAND_UNDO
- 34
Laatste bewerking ongedaan maken. - APPCOMMAND_VOLUME_DOWN
- 9
Het volume verlagen. - APPCOMMAND_VOLUME_MUTE
- 8
Het volume dempen. - APPCOMMAND_VOLUME_UP
- 10
Het volume verhogen. Het onderdeel uDevice geeft het invoerapparaat aan dat de invoer gebeurtenis heeft gegenereerd en kan een van de volgende waarden zijn.
Waarde Betekenis - FAPPCOMMAND_KEY
- 0
Gebruiker heeft op een toets gedrukt. - FAPPCOMMAND_MOUSE
- 0x8000
Gebruiker heeft op een muisknop geklikt. - FAPPCOMMAND_OEM
- 0x1000
Een niet-geïdentificeerde hardwarebron heeft de gebeurtenis gegenereerd. Dit kan een muis- of toetsenbordevenement zijn. De dwKeys component geeft aan of verschillende virtuele sleutels offline zijn en een of meer van de volgende waarden kunnen zijn.
Waarde Betekenis - MK_CONTROL
- 0x0008
De Ctrl-toets is niet beschikbaar. - MK_LBUTTON
- 0x0001
De linkermuisknop is offline. - MK_MBUTTON
- 0x0010
De middelste muisknop is omlaag. - MK_RBUTTON
- 0x0002
De rechtermuisknop is omlaag. - MK_SHIFT
- 0x0004
De Shift-toets is niet beschikbaar. - MK_XBUTTON1
- 0x0020
De XBUTTON1 is offline. - MK_XBUTTON2
- 0x0040
De XBUTTON2 is uit.
Retourwaarde
Als een toepassing dit bericht verwerkt, moet deze TRUE-retourneren. Zie de sectie Opmerkingen voor meer informatie over het verwerken van de retourwaarde.
Opmerkingen
DefWindowProc genereert het WM_APPCOMMAND bericht wanneer het bericht WM_XBUTTONUP of WM_NCXBUTTONUP wordt verwerkt, of wanneer de gebruiker een opdrachtsleutel voor een toepassing typt.
Als een onderliggend venster dit bericht niet verwerkt en in plaats daarvan DefWindowProc-aanroept, stuurt DefWindowProc het bericht naar het bovenliggende venster. Als een venster op het hoogste niveau dit bericht niet verwerkt en in plaats daarvan DefWindowProc-aanroept, roept DefWindowProc- een shellhook aan met de hookcode die gelijk is aan HSHELL_APPCOMMAND.
Als u de coördinaten van de cursor wilt ophalen als het bericht is gegenereerd door een muisklik, kan de toepassing GetMessagePos-aanroepen. Een toepassing kan testen of het bericht is gegenereerd door de muis door te controleren of lParam-FAPPCOMMAND_MOUSEbevat.
In tegenstelling tot andere Windows-berichten, moet een toepassing TRUE- van dit bericht retourneren als het wordt verwerkt. Hierdoor kan software die dit bericht simuleert op Windows-systemen ouder dan Windows 2000, bepalen of de vensterprocedure het bericht heeft verwerkt of DefWindowProc om het te verwerken.
Eisen
| Eis | Waarde |
|---|---|
| Minimaal ondersteunde client |
Windows 2000 Professional [alleen desktop-apps] |
| Minimaal ondersteunde server |
Windows 2000 Server [alleen desktop-apps] |
| Rubriek |
|