Indicateurs de pointeur

Valeurs qui peuvent apparaître dans le champ pointerFlags de la structure POINTER_INFO.

POINTER_FLAG_NONE

0x00000000

Faire défaut

POINTER_FLAG_NEW

0x00000001

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

POINTER_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_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_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_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_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_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_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_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_FLAG_CONFIDENCE

0x000004000

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_FLAG_CANCELED

0x000008000

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é.

POINTER_FLAG_DOWN

0x00010000

Indique que ce pointeur est passé à un état inférieur ; c’est-à-dire qu’elle a contacté la surface du numériseur.

POINTER_FLAG_UPDATE

0x00020000

Indique qu’il s’agit d’une mise à jour simple qui n’inclut pas les modifications d’état du pointeur.

POINTER_FLAG_UP

0x00040000

Indique que ce pointeur est passé à un état up ; autrement dit, le contact avec la surface du numériseur s’est terminé.

POINTER_FLAG_WHEEL

0x00080000

Indique l’entrée associée à une roue de pointeur. Pour les pointeurs de souris, cela équivaut à l’action de la roulette de défilement de la souris (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Indique l’entrée associée à un pointeur h-wheel. Pour les pointeurs de souris, cela équivaut à l’action de la roulette de défilement horizontale de la souris (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Indique que ce pointeur a été capturé par (associé à) un autre élément et que l’élément d’origine a perdu la capture (voir WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Indique que ce pointeur a une transformation associée.

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

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE