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 Zone Répétée
  • 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
  • Filtrage des enregistrements (Zone répétée fichier uniquement)
  • Clic sur un champ Zone répétée (code navigateur uniquement)
  • Evénements optionnels
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 associés aux champs Zone répétée
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.*

Cas particulier : Champ Zone répétée fichier rempli automatiquement :
Lors de l'exécution de ce code, le champ Zone répétée n'est pas encore rempli. Il est possible de forcer le remplissage du champ Zone répétée dans ce code avec :
Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisationEvénement présent uniquement pour les champs Zone répétée fichier remplis automatiquement :
Exécuté après le remplissage du champ Zone répétée. Ce code permet par exemple d'ajouter ou de modifier un élément du champ Zone répétée.
Entrée du champ Zone répétéeExécuté lorsqu'un des champs de la zone répétée prend le focus.
Sortie du champ Zone répétéeExécuté lors du changement de champ (touche TAB, changement de champ par la souris, etc.).
A chaque modification du champ Zone répétéeExécuté lorsque l'utilisateur modifie le contenu du champ Zone répétée.
Universal Windows 10 App Cet événement n'est pas exécuté.
Entrée en saisie dans une ligne du champ Zone répétéeExécuté lorsque l'utilisateur sélectionne une répétition pour effectuer une saisie dans cette répétition.
Universal Windows 10 App Cet événement n'est pas exécuté.
Sortie d'une ligne du champ Zone répétéeExécuté lors du changement de répétition ou lors du changement de champ (touche TAB, changement de champ par la souris, etc.) à partir d'une répétition.
Universal Windows 10 App Cet événement n'est pas exécuté.
Affichage d'une ligne du champ Zone répétéeExécuté lorsque une nouvelle répétition doit être affichée dans le champ Zone répétée : ré-affichage du champ Zone répétée, etc.
Universal Windows 10 App Cet événement n'est pas exécuté.
iPhone/iPad Cet événement n'est pas disponible dans les champs Zone répétée fichier pour des raisons de performances.
Sélection d'une ligne du champ Zone répétéeExécuté lorsque l'utilisateur sélectionne une répétition (sans saisie).
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
Cet événement est automatiquement ajouté lorsque la fonctionnalité "Rafraîchissement par tirer/relâcher (Pull to refresh)" a été activée (onglet "Détail" de la fenêtre de description du champ Zone répétée).
Cet événement est exécuté lors de la détection de la gesture de rafraîchissement sur le champ Zone répétée.
A la fin de l'exécution de cet événement, le bandeau de rafraîchissement sera automatiquement masqué sauf si la fonction ZoneRépétéeRafraîchissementVisible a été appelée.
AndroidiPhone/iPad Avant suppression automatique d'une ligne par balayage
Evénement présent uniquement si une suppression automatique a été définie lors du balayage d'une ligne (onglet "Détail" de la description du champ)
Exécuté avant la suppression automatique de l'enregistrement affiché dans la ligne. Cet événement permet par exemple de réaliser différents tests. Si cet événement renvoie Faux, la suppression n'est pas effectuée.
AndroidiPhone/iPad Après suppression automatique d'une ligne par balayage
Evénement présent uniquement si une suppression automatique a été définie lors du balayage d'une ligne (onglet "Détail" de la description du champ)
Exécuté après la suppression effective de l'enregistrement. Cet événement permet par exemple de réafficher les données.
Android Balayage d'une ligne
Evénement présent uniquement si une action a été définie lors du balayage d'une ligne (onglet "Détail" de la description du champ)
  • Cas d'une suppression automatique : Cet événement est exécuté AVANT l'événement "Avant suppression d'une ligne". Si cet événement renvoie Faux, l'événement "Avant suppression automatique d'une ligne" n'est pas exécuté et l'enregistrement n'est pas supprimé.
  • Cas d'une action par programmation : Cet événement est exécuté lors du balayage de la ligne par l'utilisateur. Cet événement permet de programmer l'action voulue.
Android Début du Glisser / Déplacer source
Exécuté au début du Glisser/Déplacer de l'élément. Cet événement permet par exemple de réaliser différents tests. Si cet événement renvoie Faux, le déplacement n'est pas effectué.
Android Lâcher en Glisser / Déplacer cible
Exécuté lorsque l'utilisateur termine le Glisser/Déplacer de l'élément. Si cet événement renvoie Faux, le déplacement n'est pas effectué.
Filtrage des enregistrementsCode optionnel présent uniquement pour les champs Zone répétée fichier remplis automatiquement :
Exécuté juste avant l'affichage d'une ligne. Cet événement permet de filtrer les enregistrements à afficher dans le champ Zone répétée. Cet événement est détaillé à la fin de cette page.
Android Cet événement n'est pas disponible.
Evénements de défilement (événements optionnels)Ces événements permettent de simplifier la gestion du déplacement de l'ascenseur vertical du champ. Les événements disponibles sont :
  • Début de défilement : Exécuté lors début du défilement de l'ascenseur vertical du champ.
  • Pendant le défilement : Exécuté lors du défilement de l'ascenseur vertical du champ.
  • Fin de défilement : Exécuté à la fin du défilement de l'ascenseur vertical du champ.
Remarque : La fonction AscenseurPosition permet de connaître la position de l'ascenseur.

(*) 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 ServeurPHP

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.
Cas particulier : Zone répétée fichier remplie automatiquement :
Lors de l'exécution de ce code, le champ Zone répétée n'est pas encore rempli. Il est possible de forcer le remplissage du champ Zone répétée dans ce code avec :
Fin d'initialisation (Code serveur)Code présent uniquement pour un champ Zone répétée fichier rempli automatiquement :
Exécuté après le remplissage du champ Zone répétée. Ce code permet par exemple d'ajouter ou de modifier un élément du champ Zone répétée.
Affichage d'une ligne (Code serveur)Exécuté lorsque une nouvelle répétition doit être affichée dans le champ Zone répétée : ré-affichage du champ Zone répétée, ...
Permet de gérer les attributs calculés.
Filtrage des enregistrements (Code serveur)Code présent uniquement pour un champ Zone répétée fichier rempli automatiquement :
Exécuté juste avant l'affichage d'une ligne. Cet événement permet de filtrer les enregistrements à afficher dans le champ Zone répétée. Cet événement est détaillé à la fin de cette page.

Remarque : Dans une page statique, seuls les événements optionnels sont disponibles.
Filtrage des enregistrements (Zone répétée fichier uniquement)
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppiPhone/iPadPHP L'événement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne du champ Zone répétée. Il est donc exécuté :
  • lors de l'initialisation du champ Zone répétée.
  • à chaque nouvel affichage d'une ligne du champ Zone répétée.
Cet événement permet de filtrer les enregistrements affichés dans le champ Zone répétée.
Pour mettre en place un filtre, l'événement "Filtrage des enregistrements" doit renvoyer une valeur :
  • Vrai pour signifier que l'enregistrement respecte le filtre et qu'il doit être affiché.
  • Faux pour signifier que l'enregistrement ne respecte pas le filtre et qu'il ne doit pas être affiché.
  • Annuler pour arrêter la lecture de la source de données du champ Zone répétée (cas très rare).
Exemple :
// -- Filtrage des enregistrements --
// Affiche uniquement les clients dont commandes sont supérieures Ã  3000 euros
SI Commande.TotalTTC >= 3000 ALORS 
RENVOYER Vrai
SINON
RENVOYER Faux
FIN
Dans ce code, les données manipulées concernent l'enregistrement en cours de lecture par le champ Zone répétée. Ces données proviennent du fichier de données ou de la requête liés au champ Zone répétée.
Remarque : Sous WINDEV et WINDEV Mobile, l'événement "Filtrage des enregistrements" est un événement optionnel. Sous WEBDEV, cet événement est proposé par défaut.
Clic sur un champ Zone répétée (code navigateur uniquement)
L'événement "Clic sur la zone répétée" est exécuté lorsque l'utilisateur clique sur une répétition du champ Zone répétée. Cet événement permet de sélectionner la répétition. Cet événement renvoie les valeurs des attributs correspondant à la répétition. Par exemple, le code de clic suivant permet de connaître la valeur de l'attribut ATT_Titre pour la répétition cliquée :
Trace(ATT_Titre)
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 bouton gauche enfoncé, relâché, avec un double-clic,
  • le bouton droit enfoncé, relâché, etc.
Pour plus de détails, consultez les Evénements optionnels.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 09/10/2023

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