- Copier un élément sur lui-même
- Doublons
- Ordre de priorité pour le tri
ArbreCopieElément (Fonction) En anglais : TreeCopyItem Copie un élément (feuille ou noeud) dans un champ Arbre. Toutes les branches issues de cet élément sont également copiées.
// Copie la feuille "Ananas" dans le noeud "Entrées"
// dans le champ Arbre "ARBRE_RecetteTV"
Res = ArbreCopieElément(ARBRE_RecetteTV, ...
"Recettes" + TAB + "Desserts" + TAB + "Salade de fruits", ...
"Recettes" + TAB + "Entrées", aPremier)
Syntaxe
<Résultat> = ArbreCopieElément(<Champ Arbre> , <Élément source> , <Élément destination> [, <Mode de tri>])
<Résultat> : Booléen - Vrai si l'élément a été copié,
- Faux dans le cas contraire.
<Champ Arbre> : Nom de champ Nom du champ Arbre à manipuler. <Élément source> : Chaîne de caractères Chemin de l'élément (feuille ou noeud) à copier. Cet élément et toutes les branches issues de cet élément seront déplacé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). <Élément destination> : Chaîne de caractères Chemin de l'élément (feuille ou noeud) correspondant au nouveau noeud "père" de l'élément copié. Cet élément doit exister. 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 si le noeud "père" est la racine du champ Arbre.
<Mode de tri> : Constante (ou combinaison de constantes) optionnelle Position de l'élément copié par rapport aux éléments "fils" du noeud destination. | | | aAccepteDoublon | Les doublons sont acceptés (deux éléments de même niveau peuvent avoir le même nom). L'élément copié est inséré suivant l'ordre alphabétique, parmi les éléments du même niveau. | | aDernier | L'élément est copié à la dernière place du niveau. | | aPremier | L'élément est copié à la première place du niveau. | aTriAlpha
(Valeur par défaut) | L'élément copié est trié suivant l'ordre alphabétique, parmi les éléments du même niveau. |
Remarques Copier un élément sur lui-même Il est impossible de copier un élément sur lui-même ou sur un de ses fils. Dans ce cas, la fonction ArbreCopieElément retourne Faux et l'élément n'est pas copié. Doublons Si l'<Elément destination> contient déjà un fils du même nom que l'<Elément source>, deux cas peuvent se présenter : - Si les doublons sont acceptés (constante aAccepteDoublon), la copie est effectuée normalement. La fonction ArbreCopieElément retourne Vrai.
- Si les doublons ne sont pas acceptés, la fonction ArbreCopieElément retourne Faux. L'élément n'est pas copié.
Si l'<Elément source> contient des doublons associés à un identifiant, les doublons sont recopiés avec le même identifiant. Ordre de priorité pour le tri L'ordre de priorité des paramètres du mode d'ajout est le suivant : - aPremier
- aDernier
- aTriAlpha
Par exemple, dans l'expression aPremier + aDernier + aTriAlpha, seule la constante aPremier est retenue et exécutée. Composante : wd280obj.dll
Documentation également disponible pour…
|
|
|
|