Indicateurs de message de pointeur

Valeurs utilisées dans différentes macros de pointeur (voir Macros).

POINTER_MESSAGE_FLAG_NEW

0x00000001

Indique l’arrivée d’un nouveau pointeur.

POINTER_MESSAGE_FLAG_INRANGE

0x00000002

Indique que ce pointeur continue d’exister. Lorsque cet indicateur n’est pas défini, il indique que le pointeur a quitté la plage de détection.

Cet indicateur n’est généralement pas défini uniquement lorsqu’un pointeur pointeur quitte la plage de détection (POINTER_FLAG_UPDATE est défini) ou lorsqu’un pointeur en contact avec une surface de fenêtre quitte la plage de détection (POINTER_FLAG_UP est défini).

POINTER_MESSAGE_FLAG_INCONTACT

0x00000004

Indique que ce pointeur est en contact avec la surface du numériseur. Lorsque cet indicateur n’est pas défini, il indique un pointeur pointant.

POINTER_MESSAGE_FLAG_FIRSTBUTTON

0x00000010

Indique une action principale, analogue à un bouton gauche de la souris vers le bas.

Un pointeur tactile a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur.

Un pointeur de stylet a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur sans bouton enfoncé.

Un pointeur de souris a cet indicateur défini lorsque le bouton gauche de la souris est enfoncé.

POINTER_MESSAGE_FLAG_SECONDBUTTON

0x00000020

Indique une action secondaire, analogue à un bouton droit de la souris vers le bas.

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur avec le bouton du canon de stylet enfoncé.

Un pointeur de souris a cet indicateur défini lorsque le bouton droit de la souris est enfoncé.

POINTER_MESSAGE_FLAG_THIRDBUTTON

0x00000040

Analogue à un bouton de la roulette de la souris vers le bas.

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Un pointeur de souris a cet indicateur défini lorsque le bouton de la roulette de la souris est enfoncé.

POINTER_MESSAGE_FLAG_FOURTHBUTTON

0x00000080

Analogue à un premier bouton de souris étendu (XButton1) vers le bas.

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Cet indicateur est défini sur un pointeur de souris lorsque le premier bouton de la souris étendue (XBUTTON1) est arrêté.

POINTER_MESSAGE_FLAG_FIFTHBUTTON

0x00000100

Analogue à un deuxième bouton de souris étendu (XButton2) vers le bas.

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Cet indicateur est défini sur un pointeur de souris lorsque le deuxième bouton de la souris étendue (XBUTTON2) est arrêté.

POINTER_MESSAGE_FLAG_PRIMARY

0x00002000

Indique que ce pointeur a été désigné comme pointeur principal. Un pointeur principal est un pointeur unique qui peut effectuer des actions au-delà de celles disponibles pour les pointeurs non principaux. Par exemple, lorsqu’un pointeur principal entre en contact avec une surface de fenêtre, il peut permettre à la fenêtre de s’activer en lui envoyant un message WM_POINTERACTIVATE.

Le pointeur principal est identifié à partir de toutes les interactions utilisateur actuelles sur le système (souris, interaction tactile, stylet, etc.). Par conséquent, le pointeur principal peut ne pas être associé à votre application. Le premier contact dans une interaction multi touch est défini comme pointeur principal. Une fois qu’un pointeur principal est identifié, tous les contacts doivent être levés avant qu’un nouveau contact puisse être identifié en tant que pointeur principal. Pour les applications qui ne traitent pas l’entrée de pointeur, seuls les événements du pointeur principal sont promus en événements de souris.

POINTER_MESSAGE_FLAG_CONFIDENCE

0x00000400

La confiance est une suggestion de l’appareil source indiquant si le pointeur représente une interaction prévue ou accidentelle, ce qui est particulièrement pertinent pour les pointeurs PT_TOUCH lorsqu’une interaction accidentelle (par exemple avec la paume de la main) peut déclencher une entrée. La présence de cet indicateur indique que l’appareil source est très sûr que cette entrée fait partie d’une interaction prévue.

POINTER_MESSAGE_FLAG_CANCELED

0x00000800

Indique que le pointeur part d’une manière anormale, par exemple quand le système reçoit une entrée non valide pour le pointeur ou lorsqu’un appareil avec des pointeurs actifs part brusquement. Si l’application recevant l’entrée est en mesure de le faire, elle doit traiter l’interaction comme non terminée et inverser les effets du pointeur concerné.

Notes

XBUTTON1 et XBUTTON2 sont des boutons supplémentaires utilisés sur de nombreux appareils de souris. Ils retournent les mêmes données que les boutons de souris standard.

Spécifications

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

Voir aussi

Constantes

Macros