WM_APPCOMMAND message

  • Article

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
Winuser.h (y compris Windows.h)

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