DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Branche à enrouler ou à dérouler
  • Gestion du bandeau de sélection lors de l'enroulement
  • Gestion du bandeau de sélection lors du déroulement
  • 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 ou déroule un élément d'un champ Table ou Table hiérarchique.
WEBDEV - Code Serveur Champ Table hiérarchique :
  • Enroule la branche si elle est 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é).
  • Déroule la branche si elle est enroulée. Les noeuds "fils" sont alors visibles dans le champ Table hiérarchique.
Champ Table :
  • Enroule la rupture si elle est déroulée. Les éléments de la rupture ne sont plus visibles dans le champ Table.
  • Déroule la rupture si elle est enroulée. Les éléments de la rupture sont alors visibles dans le champ Table.
Exemple
// Enroule ou déroule la branche sélectionnée dans le champ Table hiérarchique
SELON TableEnrouleDéroule(TABLEH_Planning)
CAS taEnroulé
Info(" La branche a été déroulée. ")
CAS taDéroulé
Info(" La branche a été enroulée. ")
CAS taErreur
Info(" La branche n'existe pas. ")
FIN
// Enroule ou déroule la branche de la première ligne du champ Table hiérarchique "TABLEH_Planning"
TableEnrouleDéroule(TABLEH_Planning, 1)
// Enroule ou déroule la branche spécifiée dans le champ Table hiérarchique
TableEnrouleDéroule(TABLEH_Planning, "MaRacine" + TAB + "MaBranche")
// Enroule ou déroule la rupture de la ligne en cours dans le champ Table "TABLE_Rupture"
TableEnrouleDéroule(TABLE_Rupture, TABLE_Rupture)
Syntaxe

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

<Résultat> = TableEnrouleDéroule(<Champ Table hiérarchique> [, <Ligne manipulée>])
<Résultat> : Entier
Etat de la branche spécifiée avant l'appel à la fonction :
taDérouleBranche déroulée.
taEnrouleBranche enroulée.
taErreurBranche inexistante.
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Ligne manipulée> : Entier optionnel
Numéro de la ligne contenant la branche à enrouler ou à dérouler. Si ce paramètre n'est pas spécifié, la branche contenue dans la ligne en cours est manipulée.
WEBDEV - Code Serveur

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

<Résultat> = TableEnrouleDéroule(<Champ Table hiérarchique> [, <Branche manipulée>])
<Résultat> : Entier
Etat de la branche spécifiée avant l'appel à la fonction :
taDérouleBranche déroulée.
taEnrouleBranche enroulée.
taErreurBranche inexistante.
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Branche manipulée> : Chaîne de caractères optionnelle
Nom de la branche à enrouler ou à dérouler. 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 manipulée.
Si deux branches correspondent au chemin spécifié, seule la première est manipulée.

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

<Résultat> = TableEnrouleDéroule(<Champ Table> [, <Ligne manipulée> [, <Rupture>]])
<Résultat> : Entier
Etat de la rupture spécifiée avant l'appel à la fonction :
taDérouleBranche déroulée.
taEnrouleBranche enroulée.
taErreurBranche inexistante.
<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.
<Ligne manipulée> : Entier optionnel
Numéro de la ligne de la rupture à enrouler ou à dérouler. 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 ou à dérouler. Si ce paramètre n'est pas spécifié, la rupture de la ligne en cours est manipulée.
<Rupture> : Chaîne de caractères optionnelle
Nom de la rupture à enrouler ou à dérouler. 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 ou déroulée. Par défaut, si des ruptures sont imbriquées, aucune rupture n'est manipulée.
Remarques

Conditions d'utilisation

La fonction TableEnrouleDéroule peut être utilisée sur :
  • WEBDEV - Code Serveur un champ Table hiérarchique.
  • un champ Table fichier.
  • un champ Table par programmation.
  • WEBDEV - Code Serveur 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 ou à dérouler

La fonction TableEnrouleDéroule n'a aucun effet :
Champ Table hiérarchiqueChamp Table avec ruptures
  • si la branche à manipuler est introuvable.
  • si la branche à manipuler est une feuille.
  • si la branche à manipuler 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 à manipuler 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 <Ligne manipulée> ou <Branche manipulée> 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) ou déroulée (équivalent à la fonction TableDérouleTout).
  • Lors de l'appel à la fonction TableEnrouleDéroule, si la branche spécifiée est déroulée et possède une procédure associée via la propriété AjouteFilsDifféré, cette procédure sera exécutée.

Gestion du bandeau de sélection lors de l'enroulement

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é ou déroulé après l'appel de la fonction TableEnrouleDéroule.
  • 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.

Gestion du bandeau de sélection lors du déroulement

La fonction TableEnrouleDéroule ne modifie pas la position du bandeau de sélection.

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.
Composante : wd290obj.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/06/2022

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