PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Traitements gérés par défaut
  • Traitements gérés par WINDEV et WINDEV Mobile
  • Traitements gérés par WEBDEV
  • Filtrage des enregistrements (Zone répétée fichier uniquement)
  • Clic sur une zone répétée (code navigateur uniquement)
  • Traitements optionnels
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
Traitements associés aux champs Zone répétée
Traitements gérés par défaut
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava

Traitements gérés par WINDEV et WINDEV Mobile

WINDEV et WINDEV Mobile gèrent par défaut les traitements suivants (ordre d'apparition sous l'éditeur de code) :
TraitementCondition d'exécution
InitialisationExécuté à l'ouverture de la fenêtre.*

Cas particulier : Zone répétée fichier remplie automatiquement :
Lors de l'exécution de ce code, la zone répétée n'est pas encore remplie. Il est possible de forcer le remplissage de la zone répétée dans ce code avec :
Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisationTraitement présent uniquement pour les champs Zone répétée fichier remplis automatiquement :
Exécuté après le remplissage de la zone répétée. Ce code permet par exemple d'ajouter ou de modifier un élément de la zone répétée.
Entrée de la zone répétéeExécuté lorsque un des champs de la zone répétée prend le focus.
Sortie de la zone répétéeExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...)
A chaque modification de la zone répétéeExécuté lorsque l'utilisateur modifie le contenu de la zone répétée.
Universal Windows 10 App Ce traitement n'est pas exécuté.
Entrée en saisie dans une ligne de la 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 Ce traitement n'est pas exécuté.
Sortie d'une ligne de la 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, ...) à partir d'une répétition.
Universal Windows 10 App Ce traitement n'est pas exécuté.
Affichage d'une ligne de la zone répétéeExécuté lorsque une nouvelle répétition doit être affichée dans la zone répétée : ré-affichage de la zone répétée, ...
Universal Windows 10 App Ce traitement n'est pas exécuté.
iPhone/iPad Ce traitement n'est pas disponible dans les champs Zone répétée fichier pour des raisons de performances.
Sélection d'une ligne de la zone répétéeExécuté lorsque l'utilisateur sélectionne une répétition (sans saisie).
Versions 20 et supérieures
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
Nouveauté 20
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
AndroidiPhone/iPad Rafraîchissement par tirer/relâcher
Ce traitement est automatiquement ajouté lorsque la fonctionnalité "Tirer pour rafraîchir" a été activée (onglet "Détail" de la fenêtre de description du champ Zone répétée).
Ce traitement 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 ce traitement, le bandeau de rafraîchissement sera automatiquement masqué sauf si la fonction ZoneRépétéeRafraîchissementVisible a été appelée.
Versions 18 et supérieures
AndroidiPhone/iPad Avant suppression automatique d'une ligne par balayage
Nouveauté 18
AndroidiPhone/iPad Avant suppression automatique d'une ligne par balayage
AndroidiPhone/iPad Avant suppression automatique d'une ligne par balayage
Traitement 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. Ce traitement permet par exemple de réaliser différents tests. Si ce traitement renvoie Faux, la suppression n'est pas effectuée.
Versions 18 et supérieures
AndroidiPhone/iPad Après suppression automatique d'une ligne par balayage
Nouveauté 18
AndroidiPhone/iPad Après suppression automatique d'une ligne par balayage
AndroidiPhone/iPad Après suppression automatique d'une ligne par balayage
Traitement 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. Ce traitement permet par exemple de réafficher les données.
Versions 18 et supérieures
Android Balayage d'une ligne
Nouveauté 18
Android Balayage d'une ligne
Android Balayage d'une ligne
Traitement 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 : Ce traitement est exécuté AVANT le traitement "Avant suppression d'une ligne". Si ce traitement renvoie Faux, le traitement "Avant suppression automatique d'une ligne" n'est pas exécuté et l'enregistrement n'est pas supprimé.
  • Cas d'une action par programmation : Ce traitement est exécuté lors du balayage de la ligne par l'utilisateur. Ce traitement permet de programmer l'action voulue.
Versions 18 et supérieures
Android Début du Glisser / Déplacer source
Nouveauté 18
Android Début du Glisser / Déplacer source
Android Début du Glisser / Déplacer source
Exécuté au début du Glisser/Déplacer de l'élément. Ce traitement permet par exemple de réaliser différents tests. Si ce traitement renvoie Faux, le déplacement n'est pas effectué.
Versions 18 et supérieures
Android Lâcher en Glisser / Déplacer cible
Nouveauté 18
Android Lâcher en Glisser / Déplacer cible
Android Lâcher en Glisser / Déplacer cible
Exécuté lorsque l'utilisateur termine le Glisser/Déplacer de l'élément. Si ce traitement 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. Ce traitement permet de filtrer les enregistrements à afficher dans la zone répétée. Ce traitement est détaillé à la fin de cette page.
Android Ce traitement n'est pas disponible.

(*) Par défaut, le traitement "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. Sélectionnez l'option "Fenêtres .. Éditer l'ordre d'initialisation".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

Traitements gérés par WEBDEV

WEBDEV gère par défaut les traitements suivants (ordre d'apparition sous l'éditeur de code) :
TraitementCondition 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, la zone répétée n'est pas encore remplie. Il est possible de forcer le remplissage de la zone répétée dans ce code avec :
Fin d'initialisation (Code serveur)Code présent uniquement pour Zone répétée fichier remplie automatiquement :
Exécuté après le remplissage de la zone répétée. Ce code permet par exemple d'ajouter ou de modifier un élément de la zone répétée.
Affichage d'une ligne (Code serveur)Exécuté lorsque une nouvelle répétition doit être affichée dans la zone répétée : ré-affichage de la zone répétée, ...
Permet de gérer les attributs calculés.
Filtrage des enregistrements (Code serveur)Code présent uniquement pour la zone répétée fichier remplie automatiquement :
Exécuté juste avant l'affichage d'une ligne. Ce traitement permet de filtrer les enregistrements à afficher dans la zone répétée. Ce traitement est détaillé à la fin de cette page.

Remarque : Dans une page statique, seuls les traitements optionnels sont disponibles.
Filtrage des enregistrements (Zone répétée fichier uniquement)
WINDEVWEBDEV - Code ServeuriPhone/iPadWindows MobileUniversal Windows 10 AppPHP Le traitement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne de la zone répétée. Il est donc exécuté :
  • lors de l'initialisation de la zone répétée.
  • à chaque nouvel affichage d'une ligne de la zone répétée.
Ce traitement permet de filtrer les enregistrements affichés dans le champ Zone répétée.
Pour mettre en place un filtre, le traitement "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 de la 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 la zone répétée. Ces données proviennent du fichier de données ou de la requête liés à la zone répétée.
Remarque : Sous WINDEV et WINDEV Mobile, le traitement "Filtrage des enregistrements" est un traitement optionnel. Sous WEBDEV, ce traitement est proposé par défaut.
Clic sur une zone répétée (code navigateur uniquement)
WEBDEV - Code Navigateur Le traitement "Clic sur la zone répétée" est exécuté lorsque l'utilisateur clique sur une répétition de la zone répétée.
Versions 17 et supérieures
Ce traitement permet de sélectionner la répétition. Ce traitement 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)
Nouveauté 17
Ce traitement permet de sélectionner la répétition. Ce traitement 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)
Ce traitement permet de sélectionner la répétition. Ce traitement 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)
Traitements optionnels
Plusieurs traitements optionnels peuvent être gérés.
Pour gérer un traitement optionnel, il suffit de le sélectionner dans la barre d'icônes de la fenêtre de code.
WINDEV et WINDEV Mobile
WEBDEV
Pour ajouter un traitement 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 traitements à xxx" situé à la fin de la fenêtre de code, après le dernier traitement.
  4. La totalité des traitements optionnels disponibles pour le champ est affichée.
  5. Cochez le traitement optionnel à ajouter et validez.
    Remarque : Il est possible de sélectionner plusieurs traitements optionnels.
  6. Le traitement optionnel sélectionné est automatiquement ajouté dans les traitements gérés par le champ.
Pour désactiver un traitement optionnel, il suffit d'effectuer les mêmes manipulations pour afficher la liste des traitements optionnels. Il suffit ensuite de décocher les traitements 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é, ...
Pour plus de détails, consultez les Traitements optionnels.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire