Retourne la position horizontale du pointeur (doigt ou stylet). La valeur renvoyée varie selon le mode d'utilisation de la fonction :
- Utilisée dans un événement lié au mouvement du pointeur (clic, déplacement, enfoncé, relâché, ...), retourne la position horizontale (X) du pointeur (doigt ou stylet) par rapport au champ ou à la fenêtre considérée.
- Utilisée dans un autre événement ou traitement, retourne la dernière position connue du pointeur dans le champ.
- Si l'appareil supporte les mouvements multi-points (multi-touch), permet de récupérer la position d'un point de contact en particulier.
Quelques exemples d'utilisation : Il est ainsi possible par exemple de connaître :
- la position du pointeur (doigt ou stylet) lors d'un clic dans un champ Image (fonction utilisée dans l'événement "Clic" du champ Image).
- la position du pointeur (doigt ou stylet) lors de son déplacement sur la surface d'un champ (fonction utilisée dans l'événement optionnel "Survol" d'un champ).
- la position du nième pointeur lors d'un mouvement multi-points (multi-touch) sur la surface d'un champ (uniquement si l'appareil le supporte).
// Position du pointeur (doigt ou stylet) lors d'un clic dans un champ Image
PositionX est un entier = GestePosX(1, gpChamp)
// Position du second pointeur enfoncé sur la surface d'un champ
PositionX est un entier = GestePosX(2, gpChamp)
// Position du pointeur par rapport au coin haut gauche de l'image affichée par le champ
// lorsque cette image n'est pas affichée dans sa totalité
PositionX est un entier = GestePosX(1, gpImage)
Syntaxe
<Résultat> = GestePosX([<Indice du pointeur> [, <Repère>]])
<Résultat> : Entier
- Position horizontale (ou abscisse) en pixels du pointeur par rapport au repère considéré,
- -1 en cas d'erreur.
<Indice du pointeur> : Entier optionnel
Indice du pointeur (doigt) dont la position horizontale doit être récupérée. Le premier pointeur en contact avec l'écran a pour indice 1.
Si ce paramètre n'est pas spécifié, la fonction retournera la position du premier pointeur en contact avec l'écran.
Si l'indice ne correspond pas un pointeur en contact avec l'écran ou si l'indice spécifié est supérieur à 1 et si l'appareil ne gère pas le multi-touch, la fonction retournera -1.
<Repère> : Constante optionnelle de type Entier
Repère utilisé pour le calcul de la position : | |
gpChamp
(valeur par défaut) | Position du pointeur par rapport au point haut gauche du champ (ou de la fenêtre si l'événement est sur la fenêtre). |
| gpEcran | Position du pointeur dans l'écran (par rapport au coin haut gauche de l'écran). |
| gpFenêtre | Position du pointeur par rapport au coin haut gauche de la fenêtre à laquelle appartient le champ sur lequel s'est produit l'événement. |
| gpImage | Position du pointeur par rapport au point haut gauche de l'image affichée par un champ Image.
Cette constante peut être utilisée lorsqu'une image n'est pas affichée dans sa totalité dans un champ Image afin de connaître la position du pointeur dans l'image d'origine (en tenant compte du zoom éventuel).
Cette constante doit être utilisée uniquement lorsque la fonction GestePosX est appelée dans un événement associé à un champ Image. Dans le cas contraire, la fonction GestePosX retournera -1. |
| gpPage | Position du pointeur par rapport au coin haut gauche de la page à laquelle appartient le champ sur lequel s'est produit l'événement. |
Remarques
Limitations
Dans le simulateur ou l'émulateur Android, la fonction GestePosX permet uniquement de récupérer la position du premier pointeur.
Divers
- Pour connaître la position verticale (Y) d'un pointeur, utilisez la fonction GestePosY.
- Pour connaître le nombre de pointeurs en contact avec l'écran, utilisez la fonction GesteNbPointeur.
- Pour connaître l'indice du pointeur ayant déclenché l'exécution d'un traitement lié à un mouvement sur l'écran, utilisez la fonction GestePointeurEncours.