Lire en anglais

Partager via


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 en cours de perte. 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 du traitement interne, la valeur peut être le handle de la fenêtre qui reçoit le message.

Valeur de retour

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 arrêté (par exemple, en appelant StopInteractionContext) et les contacts restants 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. En raison de cela, ne dépendent pas des notifications jumelées telles que WM_POINTERENTER et WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED n’inclut pas de données POINTER_INFO. Autre que 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 sélectivement une entrée de pointeur et passe le reste à DefWindowProc, le comportement résultant n’est pas défini.

Exigences

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

Voir aussi

Messages