Recherche un élément (feuille ou noeud) dans un champ Arbre et renvoie son chemin.
// Recherche de l'élément d'identifiant "1" dans le champ Arbre "ARBRE_ArbreClient"
// Remarque : tous les éléments du champ Arbre sont pris en compte
ResChemin = ArbreCherche(ARBRE_ArbreClient, 1)
// Recherche de l'élément d'identifiant "1" dans le champ Arbre "ARBRE_ArbreClient"
// Recherche à partir de la racine du champ Arbre et uniquement sur les feuilles
ResChemin = ArbreCherche(ARBRE_ArbreClient, 1, Null, aFeuille)
Syntaxe
<Résultat> = ArbreCherche(<Champ Arbre> , <Elément à rechercher> [, <Chemin de l'élément de départ> [, <Options>]])
<Résultat> : Chaîne de caractères
- Chemin de l'élément trouvé. Cette chaîne peut contenir des caractères de contrôle spécifiques. Cette chaîne peut être utilisée dans toutes les fonctions de gestion des champs Arbre. Ce chemin est de la forme :
"<Nom de la racine>" + TAB + ["<Nom du 1er noeud>" + TAB + ...
["<Nom du 2ème noeud>" + TAB + [...]]]"<Nom de la feuille>"
- Chaîne vide ("") si aucun élément ne correspond à la recherche.
<Champ Arbre> : Nom de champ
Nom du champ Arbre à manipuler.
<Elément à rechercher> : Chaîne de caractères ou entier
Identifiant de l'élément à rechercher. Cet identifiant doit être identique à celui utilisé dans les fonctions ArbreAjoute, ArbreInsère ou ArbreModifie.
<Chemin de l'élément de départ> : Chaîne de caractères optionnelle
Chemin de l'élément de départ de la recherche dans le champ Arbre. Si ce paramètre n'est pas spécifié ou correspond à la constante Null, la recherche est effectuée depuis la racine du champ Arbre.
<Options> : Constante (ou combinaison de constantes) optionnelle
Indique les caractéristiques de la recherche : | |
| aFeuille | Recherche effectuée uniquement sur les éléments feuilles du champ Arbre. |
| aNoeud | Recherche effectuée uniquement sur les éléments noeuds du champ Arbre. |
| aUnNiveau | Recherche effectuée sur un seul niveau d'arborescence (les éléments situés sous la branche de départ ne sont pas pris en compte). La recherche est effectuée uniquement sur les fils directs de l'élément de départ. |
Par défaut, la recherche est effectuée avec la combinaison aFeuille + aNoeud (tous les éléments du champ Arbre sont parcourus).
Composante : wd280obj.dll