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 :
  • WINDEV 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.
  • WINDEV une fenêtre de détail affichée pour une ligne. Pour plus de détails, consultez Gérer le détail d'une ligne d'un champ Table.
Rappel : En exécution, un noeud est enroulé lorsque le signe "+" précède le nom du noeud.
Java Les ruptures ne sont pas disponibles sur les champs Table dans cette version.
Exemple
WINDEV
// Enroule la branche sélectionnée dans le champ Table hiérarchique
TableEnroule(TABLEH_Planning)
WINDEV
// Enroule le champ Table hiérarchique "TABLEH_Planning"
TableEnroule(TABLEH_Planning, 1)
// Equivalent à : TableEnrouleTout(TABLEH_Planning)
WINDEV
// 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
WINDEV

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.
WINDEV

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.
WINDEV

Table et table hiérarchique : enrouler une fenêtre de détail Masquer les détails

TableEnroule(<Champ Table> [, <Numéro de la ligne>])
<Champ Table> : Nom de champ
Nom du champ Table ou Table hiérarchique à manipuler.
<Numéro de la ligne> : Entier optionnel
Numéro de la ligne dont le détail doit être enroulé. Si ce paramètre n'est pas spécifié, le détail de la ligne en cours est enroulé.
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.
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