- Procédure WLangage
- Interruption de la fonction <Table hiérarchique>.ListeFils
<Table hiérarchique>.ListeFils (Fonction) En anglais : <TreeView Table>.ListChild 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
Documentation également disponible pour…
|
|
|
|