Indicateurs de message de pointeur

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

POINTER_MESSAGE_FLAG_NEW

0x00000001

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

POINTER_MESSAGE_FLAG_INRANGE

0x00000002

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

En règle générale, cet indicateur n’est défini que lorsqu’un pointeur de survol quitte la plage de détection (POINTER_FLAG_UPDATE est défini) ou lorsqu’un pointeur en contact avec une surface de la fenêtre quitte la plage de détection (POINTER_FLAG_UP est définie).

POINTER_MESSAGE_FLAG_INCONTACT

0x00000004

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

POINTER_MESSAGE_FLAG_FIRSTBUTTON

0x00000010

Indique une action principale, similaire à un bouton gauche de la souris.

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

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

Cet indicateur est défini pour le pointeur de la souris lorsque le bouton gauche de la souris est enfoncé.

POINTER_MESSAGE_FLAG_SECONDBUTTON

0x00000020

Indique une action secondaire, similaire à un bouton droit de la souris.

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 digitaliseur avec le bouton du stylet du stylet enfoncé.

Cet indicateur est défini pour le pointeur de la souris lorsque le bouton droit de la souris est enfoncé.

POINTER_MESSAGE_FLAG_THIRDBUTTON

0x00000040

Similaire à un bouton de roulette de la souris.

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Cet indicateur est défini pour le pointeur de la souris lorsque le bouton roulette de la souris est enfoncé.

POINTER_MESSAGE_FLAG_FOURTHBUTTON

0x00000080

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

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Cet indicateur est défini pour le pointeur de la souris lorsque le bouton de la première souris étendue (le bouton XButton1) est enfoncé.

POINTER_MESSAGE_FLAG_FIFTHBUTTON

0x00000100

Similaire à un second bouton de la souris étendue (XButton2).

Un pointeur tactile n’utilise pas cet indicateur.

Un pointeur de stylet n’utilise pas cet indicateur.

Cet indicateur est défini pour le pointeur de la souris lorsque le bouton 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 qui sont disponibles pour les pointeurs non principaux. Par exemple, lorsqu’un pointeur principal effectue un contact avec une surface de fenêtre, il peut fournir à la fenêtre la possibilité de l’activer en lui envoyant un message de WM_POINTERACTIVATE.

Le pointeur principal est identifié à partir de toutes les interactions de l’utilisateur actuel sur le système (souris, toucher, stylet, etc.). Par conséquent, le pointeur principal peut ne pas être associé à votre application. Le premier contact dans une interaction tactile multipoint 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 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, qui est particulièrement pertinente pour les pointeurs de PT_TOUCH où une interaction accidentelle (comme 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 confiance élevée que cette entrée fait partie d’une interaction prévue.

POINTER_MESSAGE_FLAG_CANCELED

0x00000800

Indique que le pointeur se met anormalement en mode, par exemple lorsque le système reçoit une entrée non valide pour le pointeur ou lorsqu’un appareil avec des pointeurs actifs se met brusquement à part. 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

LE bouton XButton1 et XBUTTON2 sont des boutons supplémentaires utilisés sur de nombreux périphériques de souris. Elles retournent les mêmes données que les boutons de la 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