Condividi tramite


WM_POINTERCAPTURECHANGED messaggio

Inviato a una finestra che sta perdendo l'acquisizione di un puntatore di input.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

#define WM_POINTERCAPTURECHANGED           0x024C

Parametri

wParam

Contiene informazioni sul puntatore di input perso. Usare GET_POINTERID_WPARAM per ottenere l'ID puntatore.

lParam

Contiene un handle per la finestra che acquisisce il puntatore di input. Questo valore può essere NULL se il puntatore non viene più acquisito dalla finestra.

Se questo messaggio viene generato dall'elaborazione interna, il valore può essere l'handle della finestra che riceve il messaggio.

Valore restituito

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

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

Osservazioni

Una finestra deve usare questa notifica per interrompere l'elaborazione dei messaggi successivi e avviare le operazioni di pulizia necessarie per la perdita del puntatore. Anche l'elaborazione dei movimenti associati al puntatore deve essere terminata ,ad esempio chiamando StopInteractionContext) e i contatti rimanenti associati alla finestra.

In genere, se una finestra riceve la notifica di WM_POINTERCAPTURECHANGED, non vengono ricevute notifiche successive relative al puntatore di input. Per questo motivo, non dipende da notifiche abbinate, ad esempio WM_POINTERENTER e WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED non include dati POINTER_INFO. Oltre al flag POINTER_FLAG_CAPTURECHANGED impostato, i dati restituiti da GetPointerInfo (o qualsiasi variante) sono identici a quelli restituiti prima della notifica.

Se l'applicazione non elabora questa notifica, DefWindowProc può generare uno o più messaggi WM_GESTURE oppure, se un movimento non viene riconosciuto, DefWindowProc potrebbe generare l'input del mouse.

Se un'applicazione utilizza in modo selettivo un input puntatore e passa il resto a DefWindowProc, il comportamento risultante non è definito.

Fabbisogno

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)

Vedere anche

messaggi