WM_NCPOINTERUPDATE messaggio

Articolo
01/06/2024

Inviato per fornire un aggiornamento su un puntatore che ha effettuato il contatto sull'area non client di una finestra o quando un contatto non incapsulato viene spostato sull'area non client di una finestra. Mentre il puntatore passa il mouse, il messaggio è destinato a qualsiasi finestra su cui si trova il puntatore. Mentre il puntatore è in contatto con la superficie, il puntatore viene acquisito in modo implicito nella finestra su cui il puntatore ha effettuato il contatto e tale finestra continua a ricevere l'input per il puntatore fino a quando non interrompe il contatto.

Se una finestra ha acquisito questo puntatore, questo messaggio non viene pubblicato. Viene invece inserito un WM_POINTERUPDATE nella finestra che ha acquisito questo puntatore.

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

#define WM_NCPOINTERUPDATE                 0x0241

Parametri

wParam

Contiene l'identificatore del puntatore e informazioni aggiuntive. Utilizzare le macro seguenti per recuperare queste informazioni.

GET_POINTERID_WPARAM(wParam): identificatore del puntatore

HIWORD(wParam): valore hit test restituito dall'elaborazione del messaggio WM_NCHITTEST .

lParam

Contiene la posizione del punto del puntatore.

Nota

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

Utilizzare le macro seguenti per recuperare le coordinate fisiche dello schermo del punto.

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

Valore restituito

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

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

Osservazioni:

Se l'applicazione non elabora questo messaggio, DefWindowProc può eseguire una o più azioni di sistema a seconda del risultato dell'hit test incluso nel messaggio. In genere, le applicazioni non devono gestire questo messaggio.

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

Condividi tramite