MOUSE_EVENT_RECORD, structure
Important
Ce document décrit les fonctionnalités de la plateforme de la console qui ne font plus partie de la feuille de route de notre écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge des utilisations existantes pour l’avenir indéterminé. Notre solution moderne préférée se concentre sur les séquences de terminaux virtuels pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document sur les consoles classiques et les terminaux virtuels.
Décrit un événement d'entrée de souris dans une structure INPUT_RECORD de console.
Syntaxe
typedef struct _MOUSE_EVENT_RECORD {
COORD dwMousePosition;
DWORD dwButtonState;
DWORD dwControlKeyState;
DWORD dwEventFlags;
} MOUSE_EVENT_RECORD;
Membres
dwMousePosition
Une structure COORD qui contient l'emplacement du curseur, en termes de coordonnées de cellules de caractères de mémoire tampon de l'écran de la console.
dwButtonState
L’état des boutons de souris. Le bit le moins significatif correspond au bouton de souris le plus à gauche. Le bit le moins significatif suivant correspond au bouton de souris le plus à droite. Le bit suivant indique le bouton de souris le plus à gauche. Les bits correspondent alors de gauche à droite aux boutons de souris. Un bit correspond à 1 si le bouton a été appuyé.
Les constantes suivantes sont définies pour les cinq premiers boutons de souris.
| Valeur | Signification |
|---|---|
| FROM_LEFT_1ST_BUTTON_PRESSED 0x0001 | Le bouton de souris le plus à gauche. |
| FROM_LEFT_2ND_BUTTON_PRESSED 0x0004 | Le deuxième bouton en partant de la gauche. |
| FROM_LEFT_3RD_BUTTON_PRESSED 0x0008 | Le troisième bouton en partant de la gauche. |
| FROM_LEFT_4TH_BUTTON_PRESSED 0x0010 | Le quatrième bouton en partant de la gauche. |
| RIGHTMOST_BUTTON_PRESSED 0x0002 | Le bouton de souris le plus à droite. |
dwControlKeyState
L’état des touches de contrôle. Ce membre peut prendre une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
| CAPSLOCK_ON 0x0080 | L’indicateur Verr. maj est activé. |
| ENHANCED_KEY 0x0100 | La touche est améliorée. Consultez la section Remarques. |
| LEFT_ALT_PRESSED 0x0002 | La touche ALT gauche est enfoncée. |
| LEFT_CTRL_PRESSED 0x0008 | La touche Ctrl gauche est enfoncée. |
| NUMLOCK_ON 0x0020 | L’indicateur Verr. pavé num. est activé. |
| RIGHT_ALT_PRESSED 0x0001 | La touche ALT droite est enfoncée. |
| RIGHT_CTRL_PRESSED 0x0004 | La touche CTRL droite est enfoncée. |
| SCROLLLOCK_ON 0x0040 | L’indicateur Roulette vérrouillée est activée. |
| SHIFT_PRESSED 0x0010 | La touche Maj est enfoncée. |
dwEventFlags
Le type d’événement de souris Si cette valeur est égale à zéro, elle indique qu’un bouton de souris est appuyé ou relâché. Sinon, ce membre correspond à l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| DOUBLE_CLICK 0x0002 | Le deuxième clic (appui sur un bouton) d'un double-clic s'est produit. Le premier clic est renvoyé comme un événement normal d'appui sur un bouton. |
| MOUSE_HWHEELED 0x0008 | La roulette horizontale de la souris a été déplacée. Si les jeux de lettres élevés du membre dwButtonState contiennent une valeur positive, la roulette a été roulée vers la droite. Sinon, la roulette a été roulée vers la gauche. |
| MOUSE_MOVED 0x0001 | Une modification de la position de la souris s’est produite. |
| MOUSE_WHEELED 0x0004 | La roulette verticale de la souris a été déplacée. Si les jeux de lettres élevés du membre dwButtonState contiennent une valeur positive, la roulette a été roulée vers l’avant, loin de l’utilisateur. Sinon, la roulette a été roulée vers l’arrière vers l’utilisateur. |
Notes
Les événements de souris sont placés dans la mémoire tampon d’entrée lorsque la console est en mode souris (ENABLE_MOUSE_INPUT).
Les événements de souris sont générés chaque fois que l’utilisateur déplace la souris ou appuie ou relâche l’un des boutons de souris. Les événements de souris sont placés dans la mémoire tampon d'entrée d'une console uniquement lorsque le groupe de console a le focus de clavier et que le curseur se trouve à l'intérieur des bordures de la fenêtre de console.
Exemples
Pour obtenir un exemple, consultez Lecture des événements de mémoire tampon d’entrée.
Spécifications
| 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 | WinConTypes.h (via WinCon.h, inclure Windows.h) |