SourisPosY (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Erreur
Divers
Limites en code navigateur

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

SourisPosY (Fonction)

En anglais : MouseYPos

Utilisée dans un événement lié à la souris ou au stylet (code de clic, code de survol, code de bouton gauche ou droit enfoncé, ...) renvoie la position verticale (Y) 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 un champ Image (fonction utilisée dans l'événement "Clic" du champ Image)
la position de la souris (ou du stylet) lors du survol d'une fenêtre (fonction utilisée dans l'événement optionnel "Survol souris" d'une fenêtre)

Utilisée dans un événement navigateur (d'un champ ou d'une page), renvoie la position verticale (Y) du curseur de la souris selon le repère spécifié.

Remarques :

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.
Il est conseillé d'utiliser cette fonction uniquement dans les événements des champs survolés par la souris.
La fonction SourisPosY retourne la dernière position connue du doigt sur l'écran de l'appareil.

Versions 16 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible pour les applications Windows Phone.

Nouveauté 16

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible pour les applications Windows Phone.

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible pour les applications Windows Phone.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Exemple

// Survol souris de la fenêtre "FEN_Dessin"
// Code optionnel de la fenêtre
Message("Position de la souris : X : " + SourisPosX() + " Y : " + SourisPosY())

// Affiche un message différent selon l'endroit cliqué
SI SourisPosY() < 25 ALORS
Info("En haut")
SINON
Info("En bas")
FIN

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

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

<Résultat> = SourisPosY([<Repère>])

<Résultat> : Entier

Position verticale (ou ordonnée) 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
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).
spEcran Position de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtre Position de la souris par rapport au coin haut gauche de la fenêtre.
spImage Position de la souris dans l'image (par rapport au coin haut gauche de l'image).

Cette constante doit être utilisée uniquement lorsque la fonction SourisPosY est appelée dans un événement associé à un champ Image. Dans le cas contraire, la fonction SourisPosY retournera -1.

Ce paramètre n'est pas disponible.
Nouveauté 17
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).
spEcran Position de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtre Position de la souris par rapport au coin haut gauche de la fenêtre.
spImage Position de la souris dans l'image (par rapport au coin haut gauche de l'image).

Cette constante doit être utilisée uniquement lorsque la fonction SourisPosY est appelée dans un événement associé à un champ Image. Dans le cas contraire, la fonction SourisPosY retournera -1.

Ce paramètre n'est pas disponible.
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).
spEcran Position de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spFenêtre Position de la souris par rapport au coin haut gauche de la fenêtre.
spImage Position de la souris dans l'image (par rapport au coin haut gauche de l'image).

Cette constante doit être utilisée uniquement lorsque la fonction SourisPosY est appelée dans un événement associé à un champ Image. Dans le cas contraire, la fonction SourisPosY retournera -1.

Ce paramètre n'est pas disponible.

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

<Résultat> = SourisPosY([<Repère>])

<Résultat> : Entier ou réel

Position verticale (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

Indique le 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 SourisPosY doit être utilisée dans le code "OnClick" du champ.
spEcran Position de la souris dans l'écran (par rapport au coin haut gauche de l'écran).
spPage Position de la souris par rapport au coin haut gauche de la page (en tenant compte du "scrolling" de la page).

Remarques

Erreur

Les principaux cas d'erreur sont les suivants :

Aucune fenêtre n'est ouverte.
Aucun clic de souris n'est effectué.
La fonction SourisPosY n'est pas appelée dans un événement lié à la souris.
Le code de clic est exécuté par la fonction Exécute ou ExécuteTraitement.

Divers

Il est possible de connaître la position horizontale de la souris ou du stylet grâce à la fonction SourisPosX.
La fonction SourisPosY utilisée dans le code de sélection de ligne ou de table renvoie toujours 0.

Limites en code navigateur

La fonction SourisPosY 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).

Liste des exemples associés :

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 : wd270obj.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 28/03/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale