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 Table Hiérarchique
  • Evénements gérés par défaut
  • Evénements optionnels
  • Filtrage des enregistrements (champ Table hiérarchique fichier uniquement)
  • Avant l'affichage de la bulle d'aide automatique de l'ascenseur
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 Table hiérarchique
Evénements gérés par défaut
WINDEVAndroidiPhone/iPad 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 Table hiérarchique fichier rempli automatiquement
Lors de l'exécution de ce code, le champ Table hiérarchique n'est pas encore rempli. Il est possible de forcer le remplissage du champ dans ce code avec :Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisationCode présent uniquement pour les champs Table hiérarchique fichier remplis automatiquement
Exécuté après le remplissage du champ. Ce code permet par exemple de sélectionner un élément dans le champ Table hiérarchique, d'ajouter ou de modifier un élément.
Entrée dans le champ Table hiérarchiqueExécuté lorsque le champ prend le focus.
Sortie du champ Table hiérarchiqueExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...).
Entrée en saisie d'une ligne du champ Table hiérarchiqueExécuté lorsque l'utilisateur sélectionne une ligne pour effectuer une saisie dans cette ligne.
Sortie d'une ligne du champ Table hiérarchiqueExécuté lors du changement de ligne ou lors du changement de champ (touche TAB, changement de champ par la souris, ...) à partir d'une ligne.
Affichage d'une ligne du champ Table hiérarchiqueExécuté lorsqu'une nouvelle ligne doit être affichée dans le champ Table hiérarchique, par exemple lors d'une des actions suivantes : ré-affichage du champ, scrolling ou déplacement dans le champ, ...
Sélection d'une ligne du champ Table hiérarchiqueExécuté lorsque l'utilisateur sélectionne une ligne (sans saisie).
WINDEVAndroidiPhone/iPad Les champs Table hiérarchique proposent l'option suivante : "Dérouler par un clic sur la ligne". Si cette option est cochée, il sera possible de dérouler la hiérarchie en cliquant sur la ligne (et non uniquement sur l'indicateur de la hiérarchie).
AndroidiPhone/iPad Cas particulier : Option "Mode de sélection Android/iOS" sélectionnée (onglet "UI" de la fenêtre de description du champ) :
  • Si l'option "Dérouler par un clic sur la ligne" est active, l'événement "Sélection d'une ligne" n'est pas appelé lorsque l'utilisateur clique sur la ligne (s'il s'agit d'un noeud) et la valeur du champ n'est pas modifiée. L'événement "Enroulé/déroulé d'un noeud" est appelé. Dans cet événement, la valeur du champ (propriété Valeur) correspond à la ligne cliquée.
  • Si l'option "Dérouler par un clic sur la ligne" n'est pas active, l'événement "Sélection d'une ligne" n'est pas appelé lors du clic sur les boutons "+" et "-" ou sur l'icône de la hiérarchie (s'il s'agit d'un noeud). L'événement "Enroulé/déroulé d'un noeud" est appelé. Dans cet événement, la valeur du champ (propriété Valeur) correspond à la ligne cliquée.
Enroulé, Déroulé d'un noeud du champ Table hiérarchiqueExécuté lorsque l'utilisateur enroule ou déroule un noeud.
Remarque : La syntaxe NomTableHiérarchique[NomTableHiérarchique] utilisée dans cet événement permet de connaître le numéro de la ligne qui est enroulée/déroulée.

(*) 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 Navigateur 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 : champ Table hiérarchique fichier rempli automatiquement :
Lors de l'exécution de ce code, le champ Table hiérarchique n'est pas encore rempli. Il est possible de forcer le remplissage du champ Table hiérarchique dans ce code avec :
Exécuté à l'ouverture de la page.
Cas particulier : champ Table hiérarchique fichier rempli automatiquement :
Lors de l'exécution de ce code, le champ Table hiérarchique n'est pas encore rempli. Il est possible de forcer le remplissage du champ Table hiérarchique dans ce code avec :
Il est également possible de filtrer les enregistrements avec la fonction HFiltre.
Fin d'initialisation (Code serveur)Code présent uniquement pour les champs Table hiérarchique fichier remplis automatiquement
Exécuté après le remplissage du champ Table hiérarchique. Ce code permet par exemple de sélectionner un élément dans le champ, d'ajouter ou de modifier un élément.
Sélection d'une ligne de la table (Code serveur)Code exécuté lorsque l'internaute sélectionne une ligne du champ Table hiérarchique.
Affichage d'une ligne (Code serveur)Exécuté lorsqu'une nouvelle ligne doit être affichée dans le champ Table hiérarchique : ré-affichage du champ Table hiérarchique, scrolling ou déplacement dans le champ Table hiérarchique, ...
Permet de gérer les colonnes calculées.
Clic de table (Code navigateur)Exécuté lorsque l'internaute sélectionne une ligne.
Sortie d'une ligne (Code serveur)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.
Sélection d'une ligne (Code navigateur)Exécuté lorsque l'utilisateur sélectionne une ligne (sans saisie).
Filtrage des enregistrements (Code serveur)Code présent uniquement pour les champs Table hiérarchique fichier remplis automatiquement
Exécuté juste avant l'affichage d'une ligne. Cet événement permet de filtrer les enregistrements à afficher dans le champ Table hiérarchique. Cet événement est détaillé à la fin de cette page.
Enroulé, Déroulé d'une ligne (Code serveur)Exécuté lorsque l'utilisateur enroule ou déroule une ligne (ou branche).
Remarque : la syntaxe NomTableHiérarchique[NomTableHiérarchique] utilisée dans cet événement permet de connaître le numéro de la ligne qui est enroulée/déroulée.
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, ...
Remarque : Selon l'environnement (WINDEV, WEBDEV, WINDEV Mobile) et la plateforme de développement, les événements optionnels disponibles ne sont pas les mêmes.
WINDEVWEBDEV - Code ServeuriPhone/iPad
Filtrage des enregistrements (champ Table hiérarchique fichier uniquement)
L'événement "Filtrage des enregistrements" est exécuté juste après l'affichage d'une ligne du champ Table hiérarchique. Il est donc exécuté :
  • lors de l'initialisation du champ.
  • à chaque nouvel affichage d'une ligne du champ Table hiérarchique.
Cet événement permet de filtrer les enregistrements affichés dans le champ Table hiérarchique.
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 Table hiérarchique (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 Table hiérarchique. Ces données proviennent du fichier de données ou de la requête liés au champ.
Si un filtre automatique est réalisé sur le champ Table hiérarchique (fonction TableActiveFiltre ou filtre activé directement par l'utilisateur), le filtre défini par l'événement "Filtrage des enregistrements" se cumule au filtre automatique.
WINDEV
Avant l'affichage de la bulle d'aide automatique de l'ascenseur
La bulle d'aide de l'ascenseur des champs Table hiérarchique est affichée lorsque l'utilisateur clique sur la "cage" de l'ascenseur vertical de la table hiérarchique.
Cette bulle d'aide contient par défaut les informations suivantes :
  • Plage des lignes actuellement affichées dans le champ Table hiérarchique.
  • Nombre de lignes total du champ Table hiérarchique.
  • Informations sur l'élément actuellement affiché en première ligne du champ dans la colonne triée.
L'événement optionnel "Avant l'affichage de la bulle d'aide automatique de l'ascenseur" est exécuté juste avant l'affichage de cette bulle d'aide. Il est ainsi possible par exemple d'afficher un texte spécifique dans la bulle d'aide du champ Table hiérarchique à l'aide de la propriété Bulle.
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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