PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Procédure WLangage
  • Interruption de la fonction ArbreListeFils
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 Arbre. Une procédure du WLangage est appelée pour chaque "fils" trouvé.
Exemple de champ Arbre :
Vocabulaire lié à un champ Arbre
Exemple
// Liste les "fils" du noeud "Desserts" dans le champ Arbre "ARBRE_RecetteTV"
// La procédure "DérouleTout" est appelée
// pour chaque "fils" trouvé du noeud "Desserts"
Res = ArbreListeFils(ARBRE_RecetteTV, "Recettes" + TAB + "Desserts", "DérouleTout")
Syntaxe
<Résultat> = ArbreListeFils(<Champ Arbre> , <Chemin du noeud> , <Procédure WLangage> [, <Paramètre personnalisé> [, <Identifiant doublons>]])
<Résultat> : Entier
Nombre d'éléments listés.
<Champ Arbre> : Nom de champ
Nom du champ Arbre à manipuler.
<Chemin du noeud> : Chaîne de caractères
Chemin complet du noeud à partir duquel les éléments doivent être listés. 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 feuille>"
    En cas de doublons sur un élément du chemin, ce chemin peut contenir l'identifiant de l'élément (indiqué à la suite du nom grâce à la fonction ArbreID).
  • correspond à la constante NULL pour lister à partir de la racine du champ Arbre.
<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>.
<Identifiant doublons> : Booléen optionnel
Indique le mode de gestion des doublons dans les éléments :
  • Faux (par défaut) : aucune gestion n'est effectuée.
  • Vrai : les noms des éléments du chemin sont construits de manière à contenir leur identifiant.
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 Arbre>, <Chemin du fils>,..
<Élément>, <Niveau>, <Paramètre optionnel>)
Les différents paramètres sont les suivants :
  • <Champ Arbre> (chaîne de caractères avec guillemets) :
    Nom du champ Arbre à manipuler.
  • <Chemin 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 Arbre. 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.
    Remarque : si le paramètre <Identifiant doublons> est à Vrai, les noms des éléments contiendront l'identifiant associé si il existe. Pour plus de détails, consultez Gestion des doublons dans les arbres.
  • <É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 ArbreListeFils. Si le paramètre <Paramètre personnalisé> n'est pas précisé, <Paramètre personnalisé> correspond à la constante NULL.
Versions 20 et supérieures
Remarque : Cette procédure peut être une procédure interne.
Nouveauté 20
Remarque : Cette procédure peut être une procédure interne.
Remarque : Cette procédure peut être une procédure interne.

Interruption de la fonction ArbreListeFils

La fonction ArbreListeFils ne peut pas être interrompue tant qu'il reste des éléments "fils" à parcourir.
Pour forcer l'interruption du parcours effectué par la fonction ArbreListeFils, utilisez la ligne suivante dans la procédure <Procédure WLangage> :
RENVOYER Faux
Dans ce cas, la fonction ArbreListeFils retourne le nombre d'éléments parcourus jusqu'à l'appel de "RENVOYER Faux".
Composante : wd250obj.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire