WM_POINTERACTIVATE, message

Envoyé à une fenêtre inactive lorsqu’un pointeur principal génère un WM_POINTERDOWN sur la fenêtre. Tant que le message reste non géré, il se déplace vers le haut de la chaîne de fenêtre parente jusqu’à ce qu’il atteigne la fenêtre de premier niveau. Les applications peuvent répondre à ce message pour spécifier si elles souhaitent être activées.

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

#define WM_POINTERACTIVATE             0x024B

Paramètres

wParam

Contient l’identificateur du pointeur et des informations supplémentaires. Utilisez les macros suivantes pour récupérer ces informations.

GET_POINTERID_WPARAM(wParam) : identificateur de pointeur

HIWORD(wParam) : valeur de test d’accès retournée par le traitement du message WM_NCHITTEST.

lParam

Contient le handle dans la fenêtre de premier niveau de la fenêtre activée.

Valeur retournée

Si une application traite ce message, elle doit retourner l’une des valeurs décrites dans la section Remarques.

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

Notes

Une application peut gérer ce message et retourner l’une des valeurs suivantes pour déterminer comment le système traite l’activation et l’entrée d’activation :

• PA_ACTIVATE
• PA_NOACTIVATE

Il est important de noter que, lorsque l’utilisateur interagit avec le système avec plusieurs pointeurs simultanés, l’opportunité d’activation que représente le message WM_POINTERACTIVATE est disponible pour les applications uniquement pour le premier de ces pointeurs. Par conséquent, les applications doivent savoir qu’elles peuvent toujours recevoir des entrées de pointeurs pendant qu’elles sont inactives.

Si l’application ne gère pas ce message, DefWindowProc transmet le message à la fenêtre parente.

Spécifications

Condition requise	Value
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 (y compris Windows.h)

Voir aussi

Messages