DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ de saisie
  • Evénements gérés par défaut
  • Evénements gérés par WINDEV et WINDEV Mobile
  • Evénements optionnels
  • Evénement "Sélection d'une valeur dans la liste de saisie assistée"
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Evénements gérés par défaut
WINDEVUniversal Windows 10 AppJava

Evénements gérés par WINDEV et WINDEV Mobile

WINDEV et WINDEV Mobile gèrent par défaut les événements suivants (ordre d'apparition sous l'éditeur de code) :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de la fenêtre. *
EntréeExécuté lors de l'entrée du curseur de saisie dans le champ.
SortieExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...).
Ajout d'un jetonCet événement est disponible uniquement si le champ de saisie est de type "Jetons de texte".
Exécuté à chaque nouvel ajout d'un jeton dans le champ effectué par l'utilisateur. Le jeton est ajouté lors de l'utilisation d'un caractère spécifié comme séparateur de jetons.
Cet événement reçoit en paramètre une variable de type Jeton qui permet de manipuler le jeton ajouté.
Si cet événement renvoie :
  • Vrai, le jeton est ajouté dans le champ de saisie,
  • Faux, le jeton n'est pas ajouté dans le champ de saisie. La zone de saisie du champ est vidée.
Cet événement n'est pas exécuté si l'ajout est effectué par programmation.
Universal Windows 10 App Cet événement n'est pas disponible.
Suppression d'un jetonCet événement est disponible uniquement si le champ de saisie est de type "Jetons de texte".
Exécuté lors de la suppression d'un jeton par l'utilisateur via la croix du jeton.
Cet événement reçoit en paramètre une variable de type Jeton qui permet de manipuler le jeton supprimé.
Si cet événement renvoie :
  • Vrai, le jeton est supprimé dans le champ de saisie,
  • Faux, le jeton n'est pas supprimé dans le champ de saisie.
Cet événement n'est pas exécuté si la suppression est effectuée par programmation.
Universal Windows 10 App Cet événement n'est pas disponible.
Clic sur un jetonCet événement est disponible uniquement si le champ de saisie est de type "Jetons de texte".
Exécuté lors du clic sur un jeton existant dans le champ de saisie.
Cet événement reçoit en paramètre une variable de type Jeton qui permet de manipuler le jeton cliqué.
Universal Windows 10 App Cet événement n'est pas disponible.
A chaque modificationExécuté à chaque modification du contenu du champ (saisie ou effacement d'une lettre par exemple).
Nouveauté 2024
Cet événement est également exécuté lors d'un Drag and Drop d'un jeton dans un champ de saisie de type "Jetons de texte".

(*) Par défaut, l'événement "Initialisation" de chaque champ est exécuté selon l'ordre de création des différents champs dans la fenêtre. Pour modifier cet ordre d'exécution :
  1. Sous le volet "Fenêtre", dans le groupe "Ordre", cliquez sur "Initialisation".
  2. Dans la fenêtre qui s'affiche, utilisez les flèches situées sur la droite pour modifier l'ordre d'initialisation des champs.
Evénements optionnels
Plusieurs événements optionnels peuvent être gérés. Pour ajouter un événement optionnel :
  1. Sélectionnez le champ voulu.
  2. Affichez la fenêtre de code de ce champ (touche F2).
  3. Cliquez sur le lien "Ajouter d'autres événements à xxx" situé à la fin de la fenêtre de code, après le dernier événement.
  4. La totalité des événements optionnels disponibles pour le champ est affichée.
  5. Cochez l'événement optionnel à ajouter et validez.
    Remarque : Il est possible de sélectionner plusieurs événements optionnels.
  6. L'événement optionnel sélectionné est automatiquement ajouté dans les événements gérés par le champ.
Pour désactiver un événement optionnel, il suffit d'effectuer les mêmes manipulations pour afficher la liste des événements optionnels. Il suffit ensuite de décocher les événements optionnels à supprimer.
Remarque : Si le code désactivé contient du code WLangage, ce code est automatiquement supprimé.
Il est ainsi possible de gérer par exemple :
  • le survol du champ par la souris,
  • le bouton gauche enfoncé, relâché, avec un double-clic,
  • le bouton droit enfoncé, relâché, avec double-clic,
  • la roulette de la souris, etc.

Evénement "Sélection d'une valeur dans la liste de saisie assistée"

L'événement optionnel "Sélection d'une valeur dans la liste de saisie assistée" correspond à l'événement qui sera exécuté lorsque l'utilisateur sélectionne un élément de la liste de la saisie assistée. Pour simplifier sa manipulation, cet événement est associé à une procédure :
PROCÉDURE SélectionSaisieAssistée(MaSélection est un SaisieAssistée)
La variable de type SaisieAssistée contient les caractéristiques de la ligne sélectionnée dans la saisie assistée (libellé affiché et valeur mémorisée correspondante).
Cet événement permet par exemple :
  • de connaître l'option sélectionnée.
  • de modifier la valeur affichée dans le champ de saisie après la sélection.
// Ajout d'une ligne
_sa est un SaisieAssistée
_sa.Libellé = "34300(Agde)"
_sa.ValeurMémorisée = 343300
SaisieAssistéeAjoute(SAI_CP, _sa)

// -- Evénement "Sélection d'une valeur dans la liste de saisie assistée"
PROCÉDURE Sélection(MaSélection est un SaisieAssistée)
SAI_CP = MaSélection.ValeurMémorisée
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/05/2024

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