Partager via


MOUSE_EVENT_RECORD, structure

Important

Ce document décrit les fonctionnalités de plateforme console qui ne font plus partie de notre feuille de route de l’écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge les utilisations existantes pour l’avenir indéfini. Notre solution moderne préférée se concentre sur les séquences de terminal virtuel pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document de console classique et de terminal virtuel .

Décrit un événement d’entrée de souris dans une structure INPUT_RECORD console.

Syntaxe

typedef struct _MOUSE_EVENT_RECORD {
  COORD dwMousePosition;
  DWORD dwButtonState;
  DWORD dwControlKeyState;
  DWORD dwEventFlags;
} MOUSE_EVENT_RECORD;

Membres

dwMousePosition
Structure COORD qui contient l’emplacement du curseur, en termes de coordonnées de cellule caractère de la mémoire tampon de l’écran de console.

dwButtonState
État des boutons de la souris. Le bit le moins significatif correspond au bouton de la souris le plus à gauche. Le bit le moins significatif suivant correspond au bouton de la souris le plus à droite. Le bit suivant indique le bouton de la souris le plus à gauche. Les bits correspondent ensuite de gauche à droite aux boutons de la souris. Un peu est 1 si le bouton a été appuyé.

Les constantes suivantes sont définies pour les cinq premiers boutons de la souris.

Valeur Sens
FROM_LEFT_1ST_BUTTON_PRESSED 0x0001 Bouton de la souris le plus à gauche.
FROM_LEFT_2ND_BUTTON_PRESSED 0x0004 Deuxième bouton à gauche.
FROM_LEFT_3RD_BUTTON_PRESSED 0x0008 Troisième bouton de gauche.
FROM_LEFT_4TH_BUTTON_PRESSED 0x0010 Quatrième bouton de gauche.
RIGHTMOST_BUTTON_PRESSED 0x0002 Bouton de la souris le plus à droite.

dwControlKeyState
État des clés de contrôle. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Sens
CAPSLOCK_ON 0x0080 La lumière CAPS LOCK est activée.
ENHANCED_KEY 0x0100 La clé est améliorée. Voir les 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 La lumière NUM LOCK est activée.
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 La lumière SCROLL LOCK est activée.
SHIFT_PRESSED 0x0010 La touche Maj est enfoncée.

dwEventFlags
Type d’événement de souris. Si cette valeur est égale à zéro, elle indique qu’un bouton de la souris est enfoncé ou relâché. Sinon, ce membre est l’une des valeurs suivantes.

Valeur Sens
DOUBLE_CLICK 0x0002 Le deuxième clic (appuyez sur le bouton) d’un double-clic s’est produit. Le premier clic est retourné en tant qu’événement d’appui sur bouton standard.
MOUSE_HWHEELED 0x0008 La roulette horizontale de la souris a été déplacée.

Si le mot élevé du membre dwButtonState contient une valeur positive, la roue a été pivotée vers la droite. Sinon, la roue a été pivoté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 le mot élevé du membre dwButtonState contient une valeur positive, la roue a été pivotée vers l’avant, loin de l’utilisateur. Sinon, la roue a été pivotée vers l’arrière vers l’utilisateur.

Remarques

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, appuie ou relâche l’un des boutons de la 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 consoles a le focus clavier et que le curseur se trouve dans les bordures de la fenêtre de la 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 de page WinConTypes.h (via WinCon.h, incluez Windows.h)

Voir aussi

COORD

INPUT_RECORD

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput