message WM_APPCOMMAND
Avertit une fenêtre que l’utilisateur a généré un événement de commande d’application, par exemple, en cliquant sur un bouton de commande d’application à l’aide de la souris ou en tapant une touche de commande d’application sur le clavier.
#define WM_APPCOMMAND 0x0319
Paramètres
-
wParam
-
Handle vers la fenêtre où l’utilisateur a cliqué sur le bouton ou appuyé sur la touche. Il peut s’agir d’une fenêtre enfant de la fenêtre qui reçoit le message. Pour plus d’informations sur le traitement de ce message, consultez la section Remarques.
-
lParam
-
Utilisez le code suivant pour obtenir les informations contenues dans le paramètre
lParam. cmd = GET_APPCOMMAND_LPARAM(lParam); uDevice = GET_DEVICE_LPARAM(lParam); dwKeys = GET_KEYSTATE_LPARAM(lParam);La commande d’application est cmd, qui peut être l’une des valeurs suivantes.
Valeur Signification - APPCOMMAND_BASS_BOOST
- 20
Activer et désactiver les bass. - APPCOMMAND_BASS_DOWN
- 19
Diminuez les basses. - APPCOMMAND_BASS_UP
- 21
Augmentez les basses. - APPCOMMAND_BROWSER_BACKWARD
- 1
Naviguez vers l’arrière. - APPCOMMAND_BROWSER_FAVORITES
- 6
Ouvrez les favoris. - APPCOMMAND_BROWSER_FORWARD
- 2
Naviguez vers l’avant. - APPCOMMAND_BROWSER_HOME
- 7
Accédez à la maison. - APPCOMMAND_BROWSER_REFRESH
- 3
Page Actualiser. - APPCOMMAND_BROWSER_SEARCH
- 5
Ouvrez la recherche. - APPCOMMAND_BROWSER_STOP
- 4
Arrêtez le téléchargement. - APPCOMMAND_CLOSE
- 31
Fermez la fenêtre (et non l’application). - APPCOMMAND_COPY
- 36
Copiez la sélection. - APPCOMMAND_CORRECTION_LIST
- 45
Affiche la liste de correction lorsqu’un mot est identifié de manière incorrecte lors de l’entrée vocale. - APPCOMMAND_CUT
- 37
Couper la sélection. - APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
- 43
Bascule entre deux modes d’entrée vocale : dictée et commande/contrôle (donnant des commandes à une application ou accès aux menus). - APPCOMMAND_FIND
- 28
Ouvrez la boîte de dialogue Rechercher . - APPCOMMAND_FORWARD_MAIL
- 40
Transférer un message électronique. - APPCOMMAND_HELP
- 27
Ouvrez la boîte de dialogue Aide. - APPCOMMAND_LAUNCH_APP1
- 17
Démarrez App1. - APPCOMMAND_LAUNCH_APP2
- 18
Démarrez App2. - APPCOMMAND_LAUNCH_MAIL
- 15
Ouvrez le courrier électronique. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
Accédez au mode Sélectionner un média. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
Décrémentez la valeur du canal, par exemple, pour un tuner tv ou radio. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
Incrémentez la valeur du canal, par exemple, pour un tuner tv ou radio. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
Augmentez la vitesse de lecture de flux. Cela peut être implémenté de plusieurs façons, par exemple, à l’aide d’une vitesse fixe ou d’un basculement à travers une série de vitesses croissantes. - APPCOMMAND_MEDIA_NEXTTRACK
- 11
Passez à la piste suivante. - APPCOMMAND_MEDIA_PAUSE
- 47
Pause. S’il est déjà suspendu, n’effectuez aucune action supplémentaire. Il s’agit d’une commande PAUSE directe qui n’a pas d’état. S’il existe des boutons de lecture et de pause discrets, les applications doivent prendre des mesures sur cette commande, ainsi que sur APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY
- 46
Commencez à jouer à la position actuelle. S’il est déjà suspendu, il reprend. Il s’agit d’une commande PLAY directe qui n’a pas d’état. S’il existe des boutons de lecture discrets et suspendre, les applications doivent prendre des mesures sur cette commande, ainsi que sur APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY_PAUSE
- 14
Lire ou suspendre la lecture. S’il existe des boutons de lecture discrets et suspendre, les applications doivent prendre des mesures sur cette commande, ainsi que APPCOMMAND_MEDIA_PLAY et APPCOMMAND_MEDIA_PAUSE. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
Accédez à la piste précédente. - APPCOMMAND_MEDIA_RECORD
- 48
Commencez à enregistrer le flux actuel. - APPCOMMAND_MEDIA_REWIND
- 50
Revenir en arrière dans un flux à un taux de vitesse plus élevé. Cela peut être implémenté de plusieurs façons, par exemple, à l’aide d’une vitesse fixe ou d’un basculement à travers une série de vitesses croissantes. - APPCOMMAND_MEDIA_STOP
- 13
Arrêtez la lecture. - APPCOMMAND_MIC_ON_OFF_TOGGLE
- 44
Basculez le microphone. - APPCOMMAND_MICROPHONE_VOLUME_DOWN
- 25
Réduisez le volume du microphone. - APPCOMMAND_MICROPHONE_VOLUME_MUTE
- 24
Désactiver le microphone. - APPCOMMAND_MICROPHONE_VOLUME_UP
- 26
Augmentez le volume du microphone. - APPCOMMAND_NEW
- 29
Créez une nouvelle fenêtre. - APPCOMMAND_OPEN
- 30
Ouvrez une fenêtre. - APPCOMMAND_PASTE
- 38
Pâte - APPCOMMAND_PRINT
- 33
Imprimer le document actif. - APPCOMMAND_REDO
- 35
Rétablir la dernière action. - APPCOMMAND_REPLY_TO_MAIL
- 39
Répondre à un message électronique. - APPCOMMAND_SAVE
- 32
Enregistrez le document actif. - APPCOMMAND_SEND_MAIL
- 41
Envoyez un message électronique. - APPCOMMAND_SPELL_CHECK
- 42
Lancez une vérification orthographique. - APPCOMMAND_TREBLE_DOWN
- 22
Diminuez le treble. - APPCOMMAND_TREBLE_UP
- 23
Augmentez le treble. - APPCOMMAND_UNDO
- 34
Annuler la dernière action. - APPCOMMAND_VOLUME_DOWN
- 9
Réduisez le volume. - APPCOMMAND_VOLUME_MUTE
- 8
Désactivez le volume. - APPCOMMAND_VOLUME_UP
- 10
Augmentez le volume. Le composant uDevice indique l’appareil d’entrée qui a généré l’événement d’entrée et peut être l’une des valeurs suivantes.
Valeur Signification - FAPPCOMMAND_KEY
- 0
L’utilisateur a appuyé sur une touche. - FAPPCOMMAND_MOUSE
- 0x8000
L’utilisateur a cliqué sur un bouton de souris. - FAPPCOMMAND_OEM
- 0x1000
Une source matérielle non identifiée a généré l’événement. Il peut s’agir d’une souris ou d’un événement de clavier. Le composant dwKeys indique si différentes clés virtuelles sont en panne et peut être une ou plusieurs des valeurs suivantes.
Valeur Signification - MK_CONTROL
- 0x0008
La touche Ctrl est enfoncée. - MK_LBUTTON
- 0x0001
Le bouton gauche de la souris est enfoncé. - MK_MBUTTON
- 0x0010
Le bouton central de la souris est enfoncé. - MK_RBUTTON
- 0x0002
Le bouton droit de la souris est enfoncé. - MK_SHIFT
- 0x0004
La touche Maj est en panne. - MK_XBUTTON1
- 0x0020
La XBUTTON1 est en panne. - MK_XBUTTON2
- 0x0040
La XBUTTON2 est en panne.
Valeur de retour
Si une application traite ce message, elle doit retourner TRUE. Pour plus d’informations sur le traitement de la valeur de retour, consultez la section Remarques.
Remarques
DefWindowProc génère le message WM_APPCOMMAND lorsqu’il traite le message WM_XBUTTONUP ou WM_NCXBUTTONUP, ou lorsque l’utilisateur tape une clé de commande d’application.
Si une fenêtre enfant ne traite pas ce message et appelle à la place DefWindowProc, DefWindowProc envoie le message à sa fenêtre parente. Si une fenêtre de niveau supérieur ne traite pas ce message et appelle à la place DefWindowProc, DefWindowProc appelle un hook shell avec le code de raccordement égal à HSHELL_APPCOMMAND.
Pour obtenir les coordonnées du curseur si le message a été généré par un clic de souris, l’application peut appeler GetMessagePos. Une application peut tester si le message a été généré par la souris en vérifiant si lParam contient FAPPCOMMAND_MOUSE.
Contrairement aux autres messages Windows, une application doit retourner TRUE à partir de ce message s’il le traite. Cela permet aux logiciels qui simulent ce message sur les systèmes Windows antérieurs à Windows 2000 de déterminer si la procédure de fenêtre a traité le message ou appelé DefWindowProc pour le traiter.
Exigences
| Exigence | Valeur |
|---|---|
| Client minimum pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimum pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
Voir aussi
-
de référence
-
conceptuelle