WM_MOUSEHWHEEL messaggio

Inviato alla finestra attiva quando la rotellina orizzontale del mouse è inclinata o ruotata. La funzione DefWindowProc propaga il messaggio all'elemento padre della finestra. Non dovrebbe essere presente alcun inoltro interno del messaggio, poiché DefWindowProc propagarlo fino alla catena padre finché non trova una finestra che lo elabora.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

#define WM_MOUSEHWHEEL                  0x020E

Parametri

wParam

La parola di ordine elevato indica la distanza di rotazione della ruota, espressa in multipli o fattori di WHEEL_DELTA, che è impostato su 120. Un valore positivo indica che la ruota è stata ruotata a destra; un valore negativo indica che la ruota è stata ruotata a sinistra.

La parola con ordine basso indica se diverse chiavi virtuali sono inattive. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
MK_CONTROL 0x0008	Il tasto CTRL è inattivo.
MK_LBUTTON 0x0001	Il pulsante sinistro del mouse è in basso.
MK_MBUTTON 0x0010	Il pulsante centrale del mouse è in basso.
MK_RBUTTON 0x0002	Il pulsante destro del mouse è in basso.
MK_SHIFT 0x0004	Il tasto MAIUSC è inattivo.
MK_XBUTTON1 0x0020	Il XBUTTON1 è inattivo.
MK_XBUTTON2 0x0040	Il XBUTTON2 è inattivo.

lParam

La parola in ordine basso specifica la coordinata x del puntatore, rispetto all'angolo superiore sinistro dello schermo.

La parola di ordine elevato specifica la coordinata y del puntatore, rispetto all'angolo superiore sinistro dello schermo.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire zero.

Osservazioni

Usare il codice seguente per ottenere le informazioni nel parametro wParam.

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);

Usare il codice seguente per ottenere la posizione orizzontale e verticale.

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

Come indicato in precedenza, la coordinata x è nell'ordine basso breve del valore restituito; la coordinata y si trova nell' breve di ordine elevato (entrambi rappresentano valori firmati perché possono accettare valori negativi nei sistemi con più monitor). Se il valore restituito viene assegnato a una variabile, è possibile utilizzare la macro MAKEPOINTS per ottenere una struttura POINTS dal valore restituito. È anche possibile utilizzare la macro GET_X_LPARAM o GET_Y_LPARAM per estrarre la coordinata x o y.

Importante

Non utilizzare la LOWORD o macro HIWORD per estrarre le coordinate x e y della posizione del cursore perché queste macro restituiscono risultati non corretti nei sistemi con più monitor. I sistemi con più monitor possono avere coordinate x e y negative e LOWORD e HIWORD considerano le coordinate come quantità non firmate.

La rotazione della rotellina è un multiplo di WHEEL_DELTA, impostato su 120. Si tratta della soglia per l'esecuzione dell'azione e deve verificarsi un'azione di questo tipo (ad esempio, lo scorrimento di un incremento) per ogni delta.

Il delta è stato impostato su 120 per consentire a Microsoft o ad altri fornitori di creare ruote a risoluzione più fine (ad esempio, una ruota ruotando liberamente senza tacche) per inviare più messaggi per rotazione, ma con un valore più piccolo in ogni messaggio. Per usare questa funzionalità, è possibile aggiungere i valori delta in ingresso fino a quando non viene raggiunto WHEEL_DELTA (quindi per una rotazione differenziale si ottiene la stessa risposta) o scorrere le righe parziali in risposta a messaggi più frequenti. È anche possibile scegliere la granularità di scorrimento e accumulare delta fino a raggiungere.

Fabbisogno

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Winuser.h (include Windowsx.h)

Vedere anche

riferimento

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_Y_LPARAM

GET_WHEEL_DELTA_WPARAM

HIWORD

LOWORD

mouse_event

concettuale

input mouse

altre risorse

GetSystemMetrics

MAKEPOINTS

POINTS

SystemParametersInfo