DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table hiérarchique
  • Conditions d'utilisation
  • Branche à enrouler
  • Bandeau de sélection
  • Vitesse d'exécution pour les champs 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
Enroule :
  • WEBDEV - Code ServeurPHP une branche d'un champ Table hiérarchique précédemment déroulée. Les noeuds "fils" ne sont alors plus visibles dans le champ Table hiérarchique. Les noeuds fils restent dans leur état (enroulé ou déroulé).
  • une rupture d'un champ Table précédemment déroulée. Les éléments de la rupture ne sont plus visibles dans le champ Table.
Rappel : En exécution, un noeud est enroulé lorsque le signe "+" précède le nom du noeud.
Exemple
WEBDEV - Code ServeurPHP
// Enroule la branche sélectionnée dans le champ Table hiérarchique
TableEnroule(TABLEH_Planning)
WEBDEV - Code ServeurPHP
// Enroule le champ Table hiérarchique "TABLEH_Planning"
TableEnroule(TABLEH_Planning, 1)
// Equivalent à : TableEnrouleTout(TABLEH_Planning)
WEBDEV - Code ServeurPHP
// Enroule la branche spécifiée dans le champ Table hiérarchique
TableEnroule(TABLEH_Planning, "MaRacine" + TAB + "MaBranche")
// Enroule la rupture de la ligne en cours dans le champ Table "TABLE_Rupture"
TableEnroule(TABLE_Rupture, TABLE_Rupture)
Syntaxe
WEBDEV - Code ServeurPHP

Table hiérarchique : Enrouler une branche en spécifiant le numéro de la ligne Masquer les détails

TableEnroule(<Champ Table hiérarchique> [, <Numéro de la ligne>])
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Numéro de la ligne> : Entier optionnel
Numéro de la ligne contenant la branche à enrouler. Si ce paramètre n'est pas spécifié, la branche contenue dans la ligne en cours est enroulée.
WEBDEV - Code ServeurPHP

Table hiérarchique : Enrouler une branche en spécifiant son nom Masquer les détails

TableEnroule(<Champ Table hiérarchique> [, <Nom de la branche>])
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Nom de la branche> : Chaîne de caractères optionnelle
Nom de la branche à enrouler. Ce paramètre est de la forme :
"<Nom de la racine>" + TAB + ["<Nom du 1er noeud>" + TAB + ...
["<Nom du 2ème noeud>" + TAB + [...]]]"<Nom de la branche>"
Si ce paramètre ne correspond pas à une branche existante, une erreur WLangage est générée.
Si ce paramètre n'est pas spécifié, la branche contenue dans la ligne en cours est enroulée.
Si deux branches correspondent au chemin spécifié, seule la première est enroulée.

Table avec ruptures : Enrouler une rupture Masquer les détails

TableEnroule(<Champ Table> [, <Numéro de la ligne> [, <Nom de la rupture>]])
<Champ Table> : Nom de champ
Nom du champ Table à manipuler. Ce champ doit posséder une ou plusieurs ruptures. Dans le cas contraire, cette fonction n'a aucun effet.
<Numéro de la ligne> : Entier optionnel
Numéro de la ligne de la rupture à enrouler. Ce numéro doit correspondre soit au numéro de la ligne en cours, soit au numéro de la première ligne de la rupture à enrouler. Si ce paramètre n'est pas spécifié, la rupture de la ligne en cours est enroulée.
<Nom de la rupture> : Chaîne de caractères optionnelle
Nom de la rupture à enrouler. Ce paramètre doit être spécifié dans le cas de ruptures imbriquées. Il permet de définir la rupture qui sera enroulée. Par défaut, si des ruptures sont imbriquées, aucune rupture n'est enroulée.
Remarques

Conditions d'utilisation

La fonction TableEnroule peut être utilisée sur :
  • un champ Table ou Table hiérarchique fichier chargé en mémoire.
  • un champ Table ou Table hiérarchique par programmation.
  • WEBDEV - Code ServeurPHP un champ Table en mode "Serveur + AJAX" ou un champ Table en mode "Serveur".
  • WEBDEV - Code Navigateur un champ Table en mode "Navigateur".
Cette fonction ne peut pas être utilisée sur les champs Table fichier (accès direct).

Branche à enrouler

La fonction TableEnroule n'a aucun effet :
Champ Table hiérarchiqueChamp Table avec ruptures
  • si la branche à enrouler est introuvable.
  • si la branche à enrouler est une feuille.
  • si la branche à enrouler est déjà enroulée.
  • si le champ Table n'a pas de ruptures.
  • si le champ Table contient plusieurs ruptures et si la rupture à enrouler n'est pas indiquée.
  • si aucune ligne n'est sélectionnée dans le champ Table et si le paramètre <Numéro de la ligne> n'est pas spécifié.

Remarque pour les champs Table hiérarchique : Si le paramètre <Numéro de ligne> ou <Nom de la branche> correspond à la branche contenue dans la première ligne, toute la hiérarchie du champ Table hiérarchique est enroulée (équivalent à la fonction TableEnrouleTout).

Bandeau de sélection

Pour les champs Table hiérarchique :
  • Si le bandeau de sélection était positionné sur un des éléments du noeud à enrouler, le bandeau se positionne sur le noeud enroulé après l'appel de la fonction TableEnroule.
  • Le code de modification est appelé à chaque déplacement du bandeau de sélection. Si deux niveaux sont enroulés et si le bandeau de sélection se positionne sur le noeud supérieur, les codes de modification de chacun des niveaux sont exécutés.
Pour les champs Table avec ruptures, le bandeau de sélection n'est pas modifié. Il reste sur l'élément en cours même si la rupture est enroulée.

Vitesse d'exécution pour les champs Table hiérarchique

La vitesse d'exécution de la syntaxe 1 est plus rapide que celle de la syntaxe 2.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2022

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