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 une plage de détection gauche.

Cet indicateur n’est généralement pas défini uniquement lorsqu’un pointeur pointeur pointant quitte la plage de détection (POINTER_FLAG_UPDATE est défini) ou lorsqu’un pointeur en contact avec une surface de fenêtre laisse 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 de pointeur de pointage.

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 boutons enfoncés.

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 de 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 volant 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 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.

Un pointeur de souris a cet indicateur défini lorsque le premier bouton étendu de la souris (XBUTTON1) est enfoncé.

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.

Un pointeur de souris a cet indicateur défini lorsque le deuxième bouton étendu de la souris (XBUTTON2) est enfoncé.

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 contacte une surface de fenêtre, il peut fournir à la fenêtre une possibilité d’activation en l’envoyant un message WM_POINTERACTIVATE.

Le pointeur principal est identifié à partir de toutes les interactions utilisateur actuelles sur le système (souris, tactile, stylet, etc.). Par conséquent, le pointeur principal peut ne pas être associé à votre application. Le premier contact d’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é comme pointeur principal. Pour les applications qui ne traitent pas d’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, qui est particulièrement pertinente pour les pointeurs PT_TOUCH où une interaction accidentelle (par exemple, avec la paume de la main) peut déclencher l’entrée. La présence de cet indicateur indique que l’appareil source a une grande confiance 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 lorsque 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 n’étant pas terminée et inverser les effets du pointeur concerné.

Remarques

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.

Exigences

Voir aussi

constantes

macros