PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Procédure WLangage
  • Interruption de la fonction <Table hiérarchique>.ListeFils
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
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 = 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> , <Nom de la procédure> [, <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 (avec guillemets)
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.
<Nom de la procédure> : Chaîne de caractères
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> , <Nom de la procédure> [, <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.
<Nom de la procédure> : Chaîne de caractères
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>.
Remarques

Procédure WLangage

La procédure <Nom de la procédure> 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 <Nom de la procédure> (<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 avec guillemets) :
    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.
Remarque : Cette procédure peut être une procédure interne.

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 <Nom de la procédure> :
RENVOYER Faux
Dans ce cas, la fonction <Table hiérarchique>.ListeFils retourne le nombre d'éléments parcourus jusqu'à l'appel de "RENVOYER Faux".
Composante : wd260obj.dll
Voir Aussi
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire