WM_APPCOMMAND message
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
-
Descripteur de la fenêtre dans laquelle 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 la basse. - APPCOMMAND_BASS_DOWN
- 19
Diminuer les basses. - APPCOMMAND_BASS_UP
- 21
Augmenter les basses. - APPCOMMAND_BROWSER_BACKWARD
- 1
Naviguer vers l’arrière. - APPCOMMAND_BROWSER_FAVORITES
- 6
Ouvrir les favoris. - APPCOMMAND_BROWSER_FORWARD
- 2
Naviguer vers l’avant. - APPCOMMAND_BROWSER_HOME
- 7
Accéder à la page d’accueil. - APPCOMMAND_BROWSER_REFRESH
- 3
Actualiser la page. - APPCOMMAND_BROWSER_SEARCH
- 5
Ouvrir la recherche. - APPCOMMAND_BROWSER_STOP
- 4
Arrêter le téléchargement. - APPCOMMAND_CLOSE
- 31
Fermer la fenêtre (pas l’application). - APPCOMMAND_COPY
- 36
Copier la sélection. - APPCOMMAND_CORRECTION_LIST
- 45
Affiche la liste de correction lorsqu’un mot est incorrectement identifié lors de la saisie vocale. - APPCOMMAND_CUT
- 37
Couper la sélection. - APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
- 43
Bascule entre deux modes d’entrée vocale : la dictée et la commande/contrôle (en donnant des commandes à une application ou en accédant aux menus). - APPCOMMAND_FIND
- 28
Ouvrir la boîte de dialogue Rechercher. - APPCOMMAND_FORWARD_MAIL
- 40
Transférer un message électronique. - APPCOMMAND_HELP
- 27
Ouvrir la boîte de dialogue Aide. - APPCOMMAND_LAUNCH_APP1
- 17
Démarrer App1. - APPCOMMAND_LAUNCH_APP2
- 18
Démarrer App2. - APPCOMMAND_LAUNCH_MAIL
- 15
Ouvrir le courrier. - APPCOMMAND_LAUNCH_MEDIA_SELECT
- 16
Accéder au mode de sélection multimédia. - APPCOMMAND_MEDIA_CHANNEL_DOWN
- 52
Décrémenter la valeur du canal, par exemple pour une TV ou une radio. - APPCOMMAND_MEDIA_CHANNEL_UP
- 51
Incrémenter la valeur du canal, par exemple pour une TV ou une radio. - APPCOMMAND_MEDIA_FAST_FORWARD
- 49
Augmenter 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
Passer à la piste suivante. - APPCOMMAND_MEDIA_PAUSE
- 47
Suspendre. S’il est déjà en pause, ne faites rien. Il s’agit d’une commande PAUSE directe qui n’a pas d’état. S’il existe des boutons lecture et pause discrets, les applications doivent agir sur cette commande, ainsi que sur APPCOMMAND_MEDIA_PLAY_PAUSE. - APPCOMMAND_MEDIA_PLAY
- 46
Commencer à jouer à la position actuelle. S’il est déjà en pause, il reprendra. Il s’agit d’une commande PLAY directe qui n’a aucun état. S’il existe des boutons lecture et pause discrets, les applications doivent agir 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 lecture et pause distincts, les applications doivent agir sur cette commande, ainsi que sur APPCOMMAND_MEDIA_PLAY et APPCOMMAND_MEDIA_PAUSE. - APPCOMMAND_MEDIA_PREVIOUSTRACK
- 12
Accéder à la piste précédente. - APPCOMMAND_MEDIA_RECORD
- 48
Commencer à enregistrer le flux actuel. - APPCOMMAND_MEDIA_REWIND
- 50
Reculer dans un flux à une vitesse plus élevée. 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êter la lecture. - APPCOMMAND_MIC_ON_OFF_TOGGLE
- 44
Activer/désactiver le microphone. - APPCOMMAND_MICROPHONE_VOLUME_DOWN
- 25
Réduire le volume du microphone. - APPCOMMAND_MICROPHONE_VOLUME_MUTE
- 24
Désactiver le microphone. - APPCOMMAND_MICROPHONE_VOLUME_UP
- 26
Augmenter le volume du micro. - APPCOMMAND_NEW
- 29
Créer une fenêtre. - APPCOMMAND_OPEN
- 30
Ouvrir une fenêtre. - APPCOMMAND_PASTE
- 38
Coller - APPCOMMAND_PRINT
- 33
Imprimer le document en cours. - APPCOMMAND_REDO
- 35
Rétablir la dernière action. - APPCOMMAND_REPLY_TO_MAIL
- 39
Répondre à un e-mail. - APPCOMMAND_SAVE
- 32
Enregistrer le document actif. - APPCOMMAND_SEND_MAIL
- 41
Envoyer un e-mail. - APPCOMMAND_SPELL_CHECK
- 42
Lancer un correcteur orthographique. - APPCOMMAND_TREBLE_DOWN
- 22
Réduire les aigus. - APPCOMMAND_TREBLE_UP
- 23
Augmenter les aigus. - APPCOMMAND_UNDO
- 34
Annuler la dernière action. - APPCOMMAND_VOLUME_DOWN
- 9
Réduire le volume. - APPCOMMAND_VOLUME_MUTE
- 8
Désactiver le son. - APPCOMMAND_VOLUME_UP
- 10
Augmenter le volume. Le composant uDevice indique le périphérique 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 la souris. - FAPPCOMMAND_OEM
- 0x1000
Une source matérielle non identifiée a généré l’événement. Il peut s’agir d’un événement de souris ou de clavier. Le composant dwKeys indique si différentes touches virtuelles sont en panne et peuvent ê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 enfoncée. - MK_XBUTTON1
- 0x0020
Le premier bouton X est enfoncé. - MK_XBUTTON2
- 0x0040
Le deuxième bouton X est enfoncé.
Valeur retournée
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.
Notes
DefWindowProc génère le message WM_APPCOMMAND lorsqu’il traite le message WM_XBUTTONUP ou WM_NCXBUTTONUP, ou lorsque l’utilisateur tape une touche 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 d’interpréteur de commandes, le code de hook étant é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 si elle 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êtrage a traité le message ou appelé DefWindowProc pour le traiter.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|