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