PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Position de plusieurs pointeurs
  • Limitations
  • Divers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Retourne la position verticale du pointeur (doigt ou stylet). La valeur renvoyée varie selon le mode d'utilisation de la fonction :
  • Utilisée dans un traitement lié au mouvement du pointeur (clic, déplacement, enfoncé, relâché, ...), retourne la position verticale (Y) du pointeur (doigt ou stylet) par rapport au champ ou à la fenêtre considérée.
  • Utilisée dans un autre 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 par exemple possible de connaître :
  • la position du pointeur (doigt ou stylet) lors d'un clic dans une image (fonction utilisée dans le code de clic de l'image).
  • la position du pointeur (doigt ou stylet) lors de son déplacement sur la surface d'un champ (fonction utilisée dans le traitement 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).
Versions 18 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Exemple
// Position du pointeur (doigt ou stylet) lors d'un clic dans un champ Image
nY est un entier = GestePosY()
// Position du second pointeur enfoncé sur la surface d'un champ
nY est un entier = GestePosY(2)
Android
// 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é
nY est un entier = GestePosY(1, gpImage)
// 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é
nY est un entier = GestePosY(1, gpImage)
Syntaxe
<Résultat> = GestePosY([<Indice du pointeur> [, <Repère>]])
<Résultat> : Entier
  • Position verticale (ou ordonnée) 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 verticale 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,
  • de la fenêtre si l'événement est sur la fenêtre.
  • de la page si l'événement est sur la page.
gpEcranPosition du pointeur dans l'écran (par rapport au coin haut gauche de l'écran).
gpFenêtrePosition du pointeur par rapport au coin haut gauche de la fenêtre à laquelle appartient le champ sur lequel s'est produit l'événement.
WEBDEV - Code Navigateur Cette constante n'est pas disponible
gpImagePosition 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 GestePosY est appelée dans un traitement d'un champ Image. Dans le cas contraire, la fonction GestePosY retournera -1.
iPhone/iPad Cette constante n'est pas disponible.
Versions 19 et supérieures
gpPage
Nouveauté 19
gpPage
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.
AndroidiPhone/iPad Cette constante n'est pas disponible.
Remarques
Android

Position de plusieurs pointeurs

Pour gérer la position de plusieurs pointeurs sur l'écran, l'appareil doit :
  • être muni d'un dispositif multi-points (multi-touch)
  • fonctionner avec une version du système Android supérieure ou égale à la version 2.2.

Limitations

  • Android Cette fonction est disponible uniquement sur les appareils disposant d’une version d’Android supérieure ou égale à la version 2.2 (api level 8).
    Si la fonction est utilisée avec une version antérieure du système, une erreur fatale sera déclenchée.
    Pour connaître la version du système Android sur laquelle s’exécute l’application, utilisez la fonction SysVersionAndroid.
  • Android Dans le simulateur ou l'émulateur Android, la fonction GestePosY permet uniquement de récupérer la position du premier pointeur.
  • WEBDEV - Code Navigateur Le navigateur utilisé doit gérer la fonctionnalité de multi-touch.

Divers

  • Pour connaître la position horizontale (X) d'un pointeur, utilisez la fonction GestePosX.
  • 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.
Composantes
WEBDEV - Code Navigateur WDJS.DLL
Android wd230android.jar
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire