PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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
  • Cas particulier : Enroulé/Déroulé d'un noeud
  • Evénements optionnels
  • Filtrage des enregistrements (champ Arbre fichier uniquement)
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
Evénements associés aux champs Arbre
Evénements gérés par défaut
WINDEVWindows MobileJava

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. Permet par exemple, d'initialiser le contenu du champ Arbre. (*)
Versions 16 et supérieures
Fin d'initialisation
Nouveauté 16
Fin d'initialisation
Fin d'initialisation
Code présent uniquement pour les champs Arbre fichier remplis automatiquement :
Exécuté après le remplissage du champ Arbre. Ce code permet par exemple de dérouler ou enrouler un élément.
EntréeExécuté lorsque le curseur de la souris se positionne sur le champ Arbre.
SortieExécuté lorsque le champ n'est plus sélectionné.
ClicExécuté lorsque l'utilisateur clique sur un élément du champ Arbre.
Attention : Lors d'un double clic sur un élément, le code de clic est exécuté puis le code de double-clic.
Versions 16 et supérieures
Entrée en saisie d'une ligne
Nouveauté 16
Entrée en saisie d'une ligne
Entrée en saisie d'une ligne
Exécuté lorsque l'utilisateur sélectionne une ligne pour effectuer une saisie dans cette ligne.
Attention : Ce code est disponible uniquement si le champ Arbre autorise la saisie.
Versions 16 et supérieures
Sortie d'une ligne
Nouveauté 16
Sortie d'une ligne
Sortie d'une ligne
Exécuté lors du changement de ligne ou lors du changement de champ (touche TAB, changement de champ par la souris, ...) à partir d'une ligne.
Attention : Ce code est disponible uniquement si le champ Arbre autorise la saisie.
Versions 16 et supérieures
Affichage d'une ligne
Nouveauté 16
Affichage d'une ligne
Affichage d'une ligne
Exécuté lorsque une nouvelle ligne doit être affichée dans le champ Arbre.
Sélection d'une ligneExécuté lors d'une nouvelle sélection d'un élément dans le champ Arbre.
Clic droitExécuté lorsque l'utilisateur effectue un clic droit de la souris sur le champ Arbre (ou sur un de ses éléments).
Double clicExécuté lorsque l'utilisateur effectue un double-clic sur le champ Arbre (ou sur un de ses éléments).
Enroulé, déroulé d'un noeudExécuté lorsque une branche du champ Arbre est enroulée ou déroulée par clic ou double-clic de l'utilisateur ou encore par les icônes + ou -.

Attention : Lors d'un clic ou d'un double-clic, cet événement est exécuté avec l'événement "Clic". Cet événement est exécuté avant que l'action voulue soit réalisée.

Remarque : Cet événement peut accepter des paramètres (voir ci-dessous).
Versions 16 et supérieures
Filtrage des enregistrements
(événement optionnel)
Nouveauté 16
Filtrage des enregistrements
(événement optionnel)
Filtrage des enregistrements
(événement optionnel)
Evénement pris en compte dans le cas des champs Arbre fichier uniquement
Exécuté juste avant l'affichage d'une ligne. Cet événement permet de filtrer les enregistrements à afficher dans le champ Arbre. Cet événement est détaillé à la fin de cette page.

(*) 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. 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 NavigateurAjax

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
InitialisationExécuté à l'ouverture de la fenêtre. Permet par exemple, d'initialiser le contenu du champ Arbre.
Clic (navigateur)Exécuté sur le poste de l'internaute lorsque l'utilisateur clique sur un élément du champ Arbre.
Clic (serveur)Exécuté sur le serveur lorsque l'utilisateur clique sur un élément du champ Arbre.
Cas particulier : Enroulé/Déroulé d'un noeud
WINDEVWindows MobileJava L'événement "Enroulé, Déroulé d'un noeud" est exécuté lorsque une branche du champ Arbre est enroulée ou déroulée par clic ou double-clic de l'utilisateur.
Attention : Cet événement ne doit pas supprimer le noeud en cours.
Cet événement peut accepter des paramètres.
Pour gérer ces paramètres, il est nécessaire de déclarer une procédure directement dans l'événement "Enroulé, Déroulé d'un noeud".
Cette procédure doit être déclarée avec la syntaxe suivante :
PROCEDURE <Nom de la procédure>([<Chemin de l'élément> [, <Enroulé> [, <Identifiant> ]]])
<Chemin de l'élément>Variable de type Texte, contenant le chemin complet de l'élément actuellement enroulé ou déroulé. Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution.
<Enroulé>Variable de type Booléen, permettant de savoir quelle est l'action réalisée par l'utilisateur (enroule = Vrai ou déroule = Faux). Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution.
Versions 15 et supérieures
<Identifiant>
Nouveauté 15
<Identifiant>
<Identifiant>
Versions 15 et supérieures
Variable de type Texte, contenant l'identifiant de l'élément actuellement enroulé ou déroulé. Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution. L'identifiant a été fourni lors de l'appel à la fonction ArbreAjoute.
Nouveauté 15
Variable de type Texte, contenant l'identifiant de l'élément actuellement enroulé ou déroulé. Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution. L'identifiant a été fourni lors de l'appel à la fonction ArbreAjoute.
Variable de type Texte, contenant l'identifiant de l'élément actuellement enroulé ou déroulé. Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution. L'identifiant a été fourni lors de l'appel à la fonction ArbreAjoute.
Versions 16 et supérieures
Java Il est possible de déclarer une procédure dans l'événement "Enroulé,Déroulé d'un noeud".
Nouveauté 16
Java Il est possible de déclarer une procédure dans l'événement "Enroulé,Déroulé d'un noeud".
Java Il est possible de déclarer une procédure dans l'événement "Enroulé,Déroulé d'un noeud".
Exemple :
Evénements optionnels
WINDEVWindows MobileJava Plusieurs événements optionnels peuvent être gérés.
Pour gérer un événement optionnel, il suffit de le sélectionner dans la barre d'icônes de la fenêtre de code.
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 traitements à xxx" situé à la fin de la fenêtre de code, après le dernier événement.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.
Filtrage des enregistrements (champ Arbre fichier uniquement)
Versions 16 et supérieures
WINDEVWindows Mobile L'événement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne du champ Arbre. Il est donc exécuté :
  • lors de l'initialisation du champ Arbre.
  • à chaque nouvel affichage d'une ligne du champ Arbre.
Cet événement permet de filtrer les enregistrements affichés dans le champ Arbre.
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 Arbre (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 Arbre. Ces données proviennent du fichier de données ou de la requête liés au champ Arbre.
Nouveauté 16
WINDEVWindows Mobile L'événement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne du champ Arbre. Il est donc exécuté :
  • lors de l'initialisation du champ Arbre.
  • à chaque nouvel affichage d'une ligne du champ Arbre.
Cet événement permet de filtrer les enregistrements affichés dans le champ Arbre.
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 Arbre (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 Arbre. Ces données proviennent du fichier de données ou de la requête liés au champ Arbre.
WINDEVWindows Mobile L'événement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne du champ Arbre. Il est donc exécuté :
  • lors de l'initialisation du champ Arbre.
  • à chaque nouvel affichage d'une ligne du champ Arbre.
Cet événement permet de filtrer les enregistrements affichés dans le champ Arbre.
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 Arbre (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 Arbre. Ces données proviennent du fichier de données ou de la requête liés au champ Arbre.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire