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
  • Présentation du champ Table hiérarchique
  • Comment le faire ?
  • Créer un champ Table hiérarchique
  • Caractéristiques du champ
  • Colonne hiérarchique
  • Manipuler les noeuds de l'arborescence par programmation
  • Vocabulaire
  • Permuter les champs Table/Table hiérarchique
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
Présentation du champ Table hiérarchique
Le champ Table hiérarchique est le rapprochement du champ Table et du champ Arbre.
Ce champ se base sur la structure d'un champ Table (colonne, ligne, cellule) et possède une colonne de type Arbre, permettant d'introduire la notion d'arborescence, de hiérarchie. Cette notion est inexistante dans un champ Table.
Les colonnes d'un champ Table hiérarchique ont les mêmes caractéristiques que les colonnes d'un champ Table.
WINDEV Sous WINDEV, la colonne hiérarchique d'un champ Table hiérarchique peut également être une colonne conteneur.
Un champ Table hiérarchique permet une sélection simple ou multiple, ainsi qu'un tri sur les colonnes (tri par niveau hiérarchique, entre frères).
Les informations affichées dans le champ Table hiérarchique peuvent :
  • être déterminées par programmation : on parle alors de champ Table hiérarchique par programmation.
  • WINDEV provenir d'une variable : on parle alors de champ Table hiérarchique sur variable.
  • WINDEVWEBDEV - Code ServeuriPhone/iPad provenir d'un fichier de données ou d'une requête  : on parle alors de champ Table hiérarchique fichier. Seuls les champs Table hiérarchique fichier chargé en mémoire sont disponibles. Dans ce cas, le champ manipule les enregistrements du fichier de données chargés en mémoire.
Comment le faire ?

Créer un champ Table hiérarchique

Pour créer un champ de type Table hiérarchique :
  1. Sous le volet "Création", dans le groupe "Données",
    • WINDEVAndroidiPhone/iPad déroulez "Table et Liste" et sélectionnez "Table hiérarchique".
    • WEBDEV - Code Serveur déroulez "Table" et sélectionnez "Table hiérarchique". L'assistant de création du champ Table hiérarchique se lance. Cet assistant permet de :
      • sélectionner la source des données du champ Table hiérarchique.
      • sélectionner les paramètres spécifiques du champ Table hiérarchique.
  2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé.
Remarque : Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches Ctrl + Z : le champ retrouvera sa taille par défaut.

Caractéristiques du champ

Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ. Deux types d'informations peuvent être visualisées :
  • les informations concernant le champ Table hiérarchique dans son ensemble (il suffit de sélectionner le nom du champ).
  • les informations concernant chacune des colonnes du champ Table hiérarchique (il suffit de sélectionner le nom d'une des colonnes).
La plupart des caractéristiques des champs Table hiérarchique et de leurs colonnes sont identiques à celles des champs Table.
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.
Pour plus de détails sur les caractéristiques des champs Table, consultez :
Pour plus de détails sur les champs Table hiérarchique, consultez :

Colonne hiérarchique

Pour choisir la colonne contenant la hiérarchie :
  1. Affichez la fenêtre de description du champ Table hiérarchique.
  2. Dans l'onglet "Général", saisissez le numéro de colonne souhaitée dans le champ "Numéro de la colonne hiérarchique".

Manipuler les noeuds de l'arborescence par programmation

Pour modifier les images des noeuds de l'arbre d'un champ Table hiérarchique, utilisez les propriétés :
Pour plus de détails sur la manipulation par programmation des champs Table hiérarchique, consultez Manipuler un champ Table hiérarchique par programmation.
Vocabulaire
Pour manipuler simplement un champ Table hiérarchique, il est nécessaire de connaître le vocabulaire suivant :
NomDéfinition
Bandeau de sélectionPermet de visualiser l'élément sélectionné. Le plus souvent, une couleur spécifique est utilisée.
BranchePartie de l'arborescence pouvant définir un parcours :
  • de la racine à une feuille,
  • d'un noeud à un noeud,
  • d'un noeud à une feuille,
  • de la racine à un noeud.
ÉlémentNom générique correspondant au contenu d'un arbre : Racine, Noeud ou Feuille sont des éléments d'une arborescence d'une table hiérarchique
FeuilleDernier élément de l'arborescence : il n'y a aucun niveau inférieur.
NoeudNiveau intermédiaire, pouvant avoir des niveaux supérieurs (appelés également niveaux "Pères") et des niveaux inférieurs (appelés également niveaux "Fils").
Remarque : la racine et les feuilles correspondent à des noeuds spécifiques.
RacinePremier élément de l'arborescence de la table hiérarchique. Toute l'arborescence peut être déroulée à partir de cet élément.
Permuter les champs Table/Table hiérarchique
Il est possible de transformer automatiquement un champ Table hiérarchique en un champ Table et inversement :
  1. Sélectionnez le champ Table hiérarchique à transformer.
  2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez "Table / Table hiérarchique".
Liste des exemples associés :
Le champ Table hiérarchique Exemples unitaires (WINDEV) : Le champ Table hiérarchique
[ + ] Utilisation du champ "Table Hiérarchique".
Ce champ permet d'organiser les données d'une table de manière arborescente.
L'utilisateur peut alors voir uniquement les informations qui l'intéressent.
Cet exemple montre comment remplir une table hiérarchique, comment insérer des données, ajouter des fils...
WD Lien reflexif Exemples didactiques (WINDEV) : WD Lien reflexif
[ + ] Cet exemple illustre la gestion d'un lien réflexif avec les fonctions WLangage.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ Remplissage d'un champ avec contenu HFSQL (gestion automatique du lien réflexif).
2/ Remplissage par programmation.
Drag and drop Exemples unitaires (WINDEV) : Drag and drop
[ + ] Utilisation du Drag & Drop (Glisser & Déposer) avec les fonctions WLangage.

Dans cet exemple, nous abordons deux thèmes principaux :
1/ Comment gérer le Drag&Drop entre champs WINDEV
2/ Comment gérer le Drag&Drop de l'Explorateur de fichiers de Windows vers un champ WINDEV

Le Drag & Drop permet de déplacer des objets par l'intermédiaire de la souris. Lorsqu'on clique sur un objet, puis qu'on déplace la souris tout en maintenant le bouton gauche enfoncé, il s'agit du "Drag". Lorsqu'on relâche le bouton gauche, il s'agit du "Drop".
Le Drag & Drop est utilisable avec WINDEV sur  les champs Liste, Arbre, Table et Image.
Le champ Table / Table hiérarchique (colonnes de type Jauge) Exemples unitaires (WINDEV) : Le champ Table / Table hiérarchique (colonnes de type Jauge)
[ + ] Utilisation d'une colonne de type jauge ainsi que de la propriété ..TexteJauge dans un champ Table ou Table hiérarchique
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