MOUSE_EVENT_RECORD, structure

Article
12/22/2023

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)