Message WM_POINTERCAPTURECHANGED

Envoyé à une fenêtre qui perd la capture d’un pointeur d’entrée.

Une fenêtre reçoit ce message via sa fonction WindowProc.

#define WM_POINTERCAPTURECHANGED           0x024C

Paramètres

wParam

Contient des informations sur le pointeur d’entrée perdu. Utilisez GET_POINTERID_WPARAM pour obtenir l’ID du pointeur.

lParam

Contient un handle vers la fenêtre qui capture le pointeur d’entrée. Cette valeur peut être NULL si le pointeur n’est plus capturé par la fenêtre.

Si ce message est généré à partir d’un traitement interne, la valeur peut être le handle de la fenêtre qui reçoit le message.

Valeur retournée

Si une application traite ce message, elle doit retourner zéro.

Si l’application ne traite pas ce message, elle doit appeler DefWindowProc.

Remarques

Une fenêtre doit utiliser cette notification pour arrêter le traitement des messages suivants et lancer tout nettoyage requis pour la perte du pointeur. Le traitement des mouvements associés au pointeur doit également être terminé (par exemple, en appelant StopInteractionContext) et les contacts restants doivent être re-associés à la fenêtre.

En règle générale, si une fenêtre reçoit la notification WM_POINTERCAPTURECHANGED , aucune notification ultérieure liée au pointeur d’entrée n’est reçue. Pour cette raison, ne dépendez pas des notifications jumelées telles que WM_POINTERENTER et WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED n’inclut pas les données POINTER_INFO . Outre l’indicateur POINTER_FLAG_CAPTURECHANGED défini, les données retournées par GetPointerInfo (ou toute variante) sont identiques à celles retournées avant la notification.

Si l’application ne traite pas cette notification, DefWindowProc peut générer un ou plusieurs messages WM_GESTURE ou, si un mouvement n’est pas reconnu, DefWindowProc peut générer une entrée de souris.

Si une application consomme de manière sélective une entrée de pointeur et passe le reste à DefWindowProc, le comportement résultant n’est pas défini.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	Winuser.h (include Windows.h)

Voir aussi

Messages