PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Erreur
  • Divers
  • Limites en code navigateur
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
Utilisée dans un traitement lié à la souris ou au stylet (code de clic, code de survol, code de bouton gauche ou droit enfoncé, ...) renvoie la position horizontale (X) du curseur de souris par rapport au champ ou à la fenêtre considérée.
Il est ainsi possible par exemple de connaître :
  • la position de la souris (ou du stylet) lors d'un clic gauche dans une image (fonction utilisée dans le code de clic de l'image).
  • la position de la souris (ou du stylet) lors du survol d'une fenêtre (fonction utilisée dans le traitement optionnel "Survol souris" d'une fenêtre).
WEBDEV - Code Navigateur Utilisée dans un traitement navigateur (d'un champ ou d'une page), renvoie la position horizontale (X) du curseur de la souris selon le repère spécifié.
Remarques :
  • WINDEV La position de la souris peut aussi être connue avec la fonction CurseurPos. La fonction CurseurPos est conseillée uniquement pour modifier la position de la souris.
  • AndroidUniversal Windows 10 AppJava Il est conseillé d'utiliser cette fonction uniquement dans les traitements des champs survolés par la souris.
  • AndroidUniversal Windows 10 App La fonction SourisPosX retourne la dernière position connue du doigt sur l'écran de l'appareil.
Versions 16 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
WINDEVEtats et RequêtesWindows MobileJavaCode Utilisateur (MCU)
// Survol souris de la fenêtre "FEN_Dessin"
// Code optionnel de la fenêtre
Message("Position de la souris : X : " + SourisPosX() + " Y : " + SourisPosY())
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)
// Affiche un message différent selon l'endroit cliqué
SI SourisPosX() > 25 ALORS
Info("A droite")
SINON
Info("A gauche")
FIN
WEBDEV - Code Navigateur
// Survol souris de la page "Dessin"
// Code optionnel de la page
// Souris déplacée (onmousemove)
Message("Position de la souris : X : " + SourisPosX(spPage) + " Y : " + SourisPosY(spPage))
Syntaxe
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Récupérer la position de la souris dans une fenêtre Masquer les détails

<Résultat> = SourisPosX([<Repère>])
<Résultat> : Entier
  • Position horizontale (ou abscisse) en pixels de la souris (ou du stylet). Par défaut, cette position est donnée par rapport au coin haut gauche du champ sur lequel le bouton gauche de la souris a été enfoncé.
  • -1 en cas d'erreur.
<Repère> : Constante optionnelle de type Entier
Versions 17 et supérieures
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileJavaCode Utilisateur (MCU) Repère utilisé pour le calcul de la position :
spChamp
(Valeur par défaut)
Position de la souris par rapport au point haut gauche du champ (ou de la fenêtre si l'événement est sur la fenêtre).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ.
spEcranPosition de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtrePosition de la souris par rapport au coin haut gauche de la fenêtre.
spImagePosition de la souris dans l'image (par rapport au coin haut gauche de l'image).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ Image.
Nouveauté 17
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileJavaCode Utilisateur (MCU) Repère utilisé pour le calcul de la position :
spChamp
(Valeur par défaut)
Position de la souris par rapport au point haut gauche du champ (ou de la fenêtre si l'événement est sur la fenêtre).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ.
spEcranPosition de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtrePosition de la souris par rapport au coin haut gauche de la fenêtre.
spImagePosition de la souris dans l'image (par rapport au coin haut gauche de l'image).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ Image.
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileJavaCode Utilisateur (MCU) Repère utilisé pour le calcul de la position :
spChamp
(Valeur par défaut)
Position de la souris par rapport au point haut gauche du champ (ou de la fenêtre si l'événement est sur la fenêtre).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ.
spEcranPosition de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtrePosition de la souris par rapport au coin haut gauche de la fenêtre.
spImagePosition de la souris dans l'image (par rapport au coin haut gauche de l'image).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code de clic du champ Image.
WEBDEV - Code Navigateur

Récupérer la position de la souris dans une page Masquer les détails

<Résultat> = SourisPosX([<Repère>])
<Résultat> : Entier ou réel
  • Position horizontale (ou ordonnée) en pixels du curseur de la souris par rapport au repère considéré,
  • 0 si l'information n'est pas disponible (en fonction du navigateur utilisé, du champ considéré).
<Repère> : Constante optionnelle de type entier
Repère utilisé pour le calcul de la position :
spChamp
(Valeur par défaut)
Position de la souris par rapport au point haut gauche du champ (ou de la page si l'événement est sur la page).
Si cette constante est choisie, la fonction SourisPosX doit être utilisée dans le code "OnClick" du champ.
spEcranPosition de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spPagePosition de la souris par rapport au coin haut gauche de la page (en tenant compte du "scrolling" de la page).
Remarques
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Erreur

Les principaux cas d'erreur sont les suivants :
  • Aucune fenêtre n'est ouverte.
  • Aucun clic de souris n'est effectué.
  • La fonction SourisPosX est appelée dans un code différent du code de clic d'un champ.
  • Code de clic exécuté par la fonction Exécute ou ExécuteTraitement.
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Divers

  • Il est possible de connaître la position verticale de la souris (ou du stylet) grâce à la fonction SourisPosY.
  • La fonction SourisPosX utilisée dans le code de sélection de ligne ou de table renvoie toujours 0.
  • AndroidUniversal Windows 10 AppJava Il est conseillé d'utiliser cette fonction uniquement dans les traitements des champs survolés par la souris.
WEBDEV - Code Navigateur

Limites en code navigateur

La fonction SourisPosX n'est pas disponible :
  • dans les procédures navigateur.
  • dans les événements appelés directement ou indirectement depuis une procédure navigateur (par l'intermédiaire de la fonction ExécuteTraitement par exemple).
  • dans le code navigateur d'un bouton ou d'un lien.
Liste des exemples associés :
Les fonctions de dessin Exemples unitaires (WINDEV) : Les fonctions de dessin
[ + ] Utilisation des principales fonctions de dessin de WINDEV pour :
- Initialiser un champ Image pour dessiner
- Dessiner des figures simples
- Ecrire un texte dans un dessin
- Changer la couleur dans un dessin
Composante : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire