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é.
// 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 = TABLEH_RecetteTV.ListeFils("Recettes" + TAB + "Desserts", "DérouleTout")
Syntaxe
Lister les fils d'une branche identifiée par son chemin Masquer les détails
<Résultat> = <Champ Table hiérarchique>.ListeFils(<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> = <Champ Table hiérarchique>.ListeFils(<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 <Table hiérarchique>.ListeFils. Si le paramètre <Paramètre personnalisé> n'est pas précisé, <Paramètre personnalisé> correspond à la constante NULL.
Interruption de la fonction <Table hiérarchique>.ListeFils
La fonction
<Table hiérarchique>.ListeFils ne peut pas être interrompue tant qu'il reste des éléments "fils" à parcourir.
Pour forcer l'interruption du parcours effectué par la fonction
<Table hiérarchique>.ListeFils, utilisez la ligne suivante dans la procédure <Procédure WLangage> :
Dans ce cas, la fonction
<Table hiérarchique>.ListeFils retourne le nombre d'éléments parcourus jusqu'à l'appel de "RENVOYER Faux".
Composante : wd280obj.dll