DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table hiérarchique
  • Procédure WLangage
  • Interruption de la fonction TableListeFils
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
Liste les "fils" d'un noeud et les éléments "fils" de ces "fils" dans un champ Table hiérarchique. Une procédure du WLangage est appelée pour chaque "fils" trouvé.
Exemple
// Liste les "fils" du noeud "Desserts" dans le champ Table hiérarchique "TABLEH_RecetteTV"
// La procédure "DérouleTout" est appelée pour chaque "fils" trouvé du noeud "Desserts"
nNbDesserts est un entier
nNbDesserts = TableListeFils(TABLEH_RecetteTV, "Recettes" + TAB + "Desserts", "DérouleTout")
Syntaxe

Lister les fils d'une branche identifiée par son chemin Masquer les détails

<Résultat> = TableListeFils(<Champ Table hiérarchique> , <Nom de l'élément> , <Procédure WLangage> [, <Paramètre personnalisé>])
<Résultat> : Entier
Nombre d'éléments listés.
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Nom de l'élément> : Chaîne de caractères
Nom de l'élément à manipuler. 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 l'élément>"
Si ce paramètre ne correspond pas à un élément existant, une erreur WLangage est générée.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage appelée chaque fois qu'un élément "fils" est trouvé.
<Paramètre personnalisé> : Entier optionnel
Paramètre passé à la procédure <Nom de la procédure>.

Lister les fils d'une branche identifiée par son indice Masquer les détails

<Résultat> = TableListeFils(<Champ Table hiérarchique> , <Numéro de la ligne> , <Procédure WLangage> [, <Paramètre personnalisé>])
<Résultat> : Entier
Nombre d'éléments listés.
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
<Numéro de la ligne> : Entier
Numéro de la ligne correspondant à la branche à manipuler.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage appelée chaque fois qu'un élément "fils" est trouvé.
<Paramètre personnalisé> : Entier optionnel
Paramètre passé à la procédure <Procédure WLangage>.
Remarques

Procédure WLangage

La procédure <Procédure WLangage> est appelée pour chaque élément "fils" trouvé. Cette procédure est une procédure du WLangage.
Cette procédure doit être déclarée de la manière suivante :
PROCEDURE <Procédure WLangage> (<Champ Table hiérarchique>, <Branche du fils>,..
<Élément>, <Niveau>, <Paramètre optionnel>)
Les différents paramètres sont les suivants :
  • <Champ Table hiérarchique> (chaîne de caractères) :
    Nom du champ Table hiérarchique à manipuler.
  • <Branche du fils> (chaîne de caractères) :
    Chemin complet du "fils" trouvé (sans le nom) ou une chaîne vide ("") s'il s'agit de la racine du champ Table hiérarchique. Ce paramètre contient toujours l'élément séparateur "TAB" à la fin. Ce paramètre sera initialisé et renseigné à chaque appel de la procédure.
  • <Élément> (chaîne de caractères) :
    Nom de l'élément trouvé. Ce paramètre sera initialisé et renseigné à chaque appel de la procédure.
  • <Niveau> (entier) :
    Niveau de l'élément trouvé par rapport à l'élément initial de recherche :
    1. Fils direct
    2. Petit-fils
    3. ...
  • <Paramètre optionnel> (entier) :
    Valeur passée dans le paramètre <Paramètre personnalisé> de la fonction TableListeFils. Si le paramètre <Paramètre personnalisé> n'est pas précisé, <Paramètre personnalisé> correspond à la constante NULL.
Remarque : Cette procédure peut être une procédure interne.

Interruption de la fonction TableListeFils

La fonction TableListeFils ne peut pas être interrompue tant qu'il reste des éléments "fils" à parcourir.
Pour forcer l'interruption du parcours effectué par la fonction TableListeFils, utilisez la ligne suivante dans la procédure <Procédure WLangage> :
RENVOYER Faux
Dans ce cas, la fonction TableListeFils retourne le nombre d'éléments parcourus jusqu'à l'appel de "RENVOYER Faux".
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 21
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