WM_POINTERWHEEL messaggio

Articolo
06/03/2023

Pubblicato nella finestra con lo stato attivo della tastiera in primo piano quando viene ruotata una rotellina di scorrimento.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

! [Importante]
Le app desktop devono essere consapevoli di DPI. Se l'app non è a conoscenza di DPI, le coordinate dello schermo contenute nei messaggi puntatore e nelle strutture correlate potrebbero risultare imprecise a causa della virtualizzazione DPI. La virtualizzazione DPI offre il supporto automatico per la scalabilità alle applicazioni che non sono consapevoli di DPI ed è attiva per impostazione predefinita (gli utenti possono disattivarlo). Per altre informazioni, vedere Scrittura di applicazioni Win32 con dpi elevati.

#define WM_POINTERWHEEL            0x024E

Parametri

wParam

Contiene l'identificatore del puntatore e il delta della ruota. Usare le macro seguenti per recuperare queste informazioni.

GET_POINTERID_WPARAM(wParam): identificatore del puntatore.

GET_WHEEL_DELTA_WPARAM(wParam): delta della ruota come valore breve firmato.

lParam

Contiene la posizione del puntatore.

Nota

Poiché il puntatore può contattare il dispositivo su un'area non semplice, questa posizione del punto può essere una semplificazione di un'area puntatore più complessa. Se possibile, un'applicazione deve usare le informazioni complete sull'area del puntatore anziché sulla posizione del punto.

Usare le macro seguenti per recuperare le coordinate dello schermo fisico del punto.

GET_X_LPARAM(lParam): coordinata x (punto orizzontale).
GET_Y_LPARAM(lParam): coordinata y (punto verticale).

Valore restituito

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

Se l'applicazione non elabora questo messaggio, deve chiamare DefWindowProc.

Commenti

Per recuperare le unità di scorrimento della rotellina, usare il file inputData della struttura POINTER_INFO restituita chiamando la funzione GetPointerInfo . Questo campo contiene un valore firmato ed è espresso in più WHEEL_DELTA. Un valore positivo indica una rotazione in avanti e un valore negativo indica una rotazione indietro.

Si noti che gli input della rotellina possono essere recapitati anche se il cursore del mouse si trova all'esterno della finestra dell'applicazione. I messaggi della rotellina vengono recapitati in modo molto simile agli input della tastiera. La finestra dello stato attivo della coda di messaggi precedente riceve i messaggi della ruota.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Messaggi

Share via