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 gérés par WEBDEV
  • Evénements optionnels
  • Evénement "Validation par le clavier"
  • 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 AppAndroidiPhone/iPadJava

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).

(*) 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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP

Evénements gérés par WEBDEV

WEBDEV gère par défaut les événements suivants (ordre d'apparition sous l'éditeur de code) :
EvénementCondition d'exécution
Initialisation (Code serveur)Exécuté à l'ouverture de la page.
Entrée de champ (Code navigateur)Exécuté lorsque le champ prend le focus.
A chaque modification (Code navigateur)Exécuté à chaque modification du contenu du champ (saisie ou effacement d'une lettre par exemple). Il est ainsi possible d'effectuer des vérifications en cours de frappe ou de proposer une assistance rapide, sans retour au serveur.
Sortie avec modification (Code navigateur)Exécuté lors du changement de champ (changement de champ par la souris, ...) après que le contenu du champ ait été modifié (saisie ou effacement d'une lettre par exemple).
Sortie de champ (Code navigateur)Exécuté lors du changement de champ (changement de champ par la souris, ...).
Ajout d'un jeton (Code navigateur)Cet é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.
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.
Clic sur un jeton (Code navigateur)Cet é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.
Suppression d'un jeton (Code navigateur)Cet é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.
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.

Remarque : Dans une page statique, seuls les codes navigateur sont disponibles.
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.
AndroidiPhone/iPad

Evénement "Validation par le clavier"

L'événement optionnel "Validation par le clavier" correspond à l'événement qui sera exécuté lorsque le bouton en bas à droite du clavier alphabétique sera utilisé.
Pour paramétrer ce bouton :
  1. Affichez l'onglet "Détail" de la fenêtre de description du champ de saisie.
  2. Dans l'option "Bouton clavier", sélectionnez le type de bouton voulu. Selon le type sélectionné, le système affichera le bouton correspondant dans la langue en cours sur l'appareil.

  3. Validez.
  4. Affichez le code du champ de saisie.
  5. Ajoutez si nécessaire l'événement optionnel "Validation par le clavier" et saisissez le code correspondant à l'action voulue.

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 une 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 : 06/04/2023

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