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

Voir aussi

Référence

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

Conceptuel

Entrées de la souris