Struttura MOUSE_EVENT_RECORD

Articolo
10/23/2023

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Descrive un evento di input del mouse in una struttura di INPUT_RECORD console.

Sintassi

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

Membri

dwMousePosition
Struttura COORD che contiene la posizione del cursore, in termini di coordinate della cella di caratteri del buffer dello schermo della console.

dwButtonState
Stato dei pulsanti del mouse. Il bit meno significativo corrisponde al pulsante del mouse più a sinistra. Il bit meno significativo successivo corrisponde al pulsante del mouse più a destra. Il bit successivo indica il pulsante del mouse accanto a sinistra. I bit corrispondono quindi da sinistra a destra ai pulsanti del mouse. Un bit è 1 se il pulsante è stato premuto.

Le costanti seguenti sono definite per i primi cinque pulsanti del mouse.

valore	Significato
0x0001 FROM_LEFT_1ST_BUTTON_PRESedizione Standard D	Pulsante sinistro del mouse.
0x0004 FROM_LEFT_2ND_BUTTON_PRESedizione Standard D	Secondo pulsante a sinistra.
0x0008 FROM_LEFT_3RD_BUTTON_PRESedizione Standard D	Terzo pulsante a sinistra.
0x0010 FROM_LEFT_4TH_BUTTON_PRESedizione Standard D	Quarto pulsante a sinistra.
0x0002 RIGHTMOST_BUTTON_PRESedizione Standard D	Pulsante destro del mouse.

dwControlKeyState
Stato dei tasti di controllo. Questo membro può essere uno o più dei valori seguenti.

valore	Significato
C piattaforma di strumenti analiticiLOCK_ON 0x0080	La luce C piattaforma di strumenti analitici LOCK è attivata.
ENHANCED_KEY 0x0100	La chiave è migliorata. Vedere le osservazioni.
LEFT_ALT_PRESedizione Standard D 0x0002	Viene premuto il tasto ALT a sinistra.
0x0008 LEFT_CTRL_PRESedizione Standard D	Viene premuto il tasto CTRL sinistro.
NUMLOCK_ON 0x0020	La luce NUM LOCK è attivata.
0x0001 RIGHT_ALT_PRESedizione Standard D	Viene premuto il tasto ALT destro.
0x0004 RIGHT_CTRL_PRESedizione Standard D	Viene premuto il tasto CTRL destro.
SCROLLLOCK_ON 0x0040	La luce SCROLL LOCK è attivata.
SHIFT_PRESedizione Standard D 0x0010	Il tasto MAIUSC viene premuto.

dwEventFlags
Tipo di evento del mouse. Se questo valore è zero, indica che viene premuto o rilasciato un pulsante del mouse. In caso contrario, questo membro è uno dei valori seguenti.

valore	Significato
DOUBLE_CLICK 0x0002	Si è verificato il secondo clic (pressione del pulsante) di un doppio clic. Il primo clic viene restituito come normale evento di pressione del pulsante.
0X0008 MOU edizione Standard_HWHedizione Enterprise LED	La rotellina orizzontale del mouse è stata spostata. Se la parola alta del membro dwButtonState contiene un valore positivo, la rotellina è stata ruotata a destra. In caso contrario, la ruota era ruotata a sinistra.
MOU edizione Standard_MOVED 0x0001	Si è verificata una modifica della posizione del mouse.
0X0004 MOU edizione Standard_WHedizione Enterprise LED	La rotellina verticale del mouse è stata spostata. Se la parola alta del membro dwButtonState contiene un valore positivo, la rotellina è stata ruotata in avanti, lontano dall'utente. In caso contrario, la ruota era ruotata all'indietro, verso l'utente.

Osservazioni:

Gli eventi del mouse vengono inseriti nel buffer di input quando la console è in modalità mouse (ENABLE_MOUedizione Standard_INPUT).

Gli eventi del mouse vengono generati ogni volta che l'utente sposta il mouse o preme o rilascia uno dei pulsanti del mouse. Gli eventi del mouse vengono inseriti nel buffer di input di una console solo quando il gruppo della console ha lo stato attivo della tastiera e il cursore si trova entro i bordi della finestra della console.

Esempi

Un esempio è disponibile in Lettura di eventi del buffer di input.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	WinConTypes.h (tramite WinCon.h, includere Windows.h)