- Déplacer un élément sur lui-même
- Doublons
- Ordre de priorité pour le tri
ArbreDéplaceElément (Fonction) En anglais : TreeMoveItem Déplace un élément (feuille ou noeud) dans un champ Arbre. Toutes les branches issues de cet élément sont également déplacées.
// Déplacement de la feuille "Ananas" dans le noeud "Entrées"
// dans le champ Arbre "ARBRE_RecetteTV"
Res = ArbreDéplaceElément(ARBRE_RecetteTV, ...
"Recettes" + TAB + "Desserts" + TAB + "Salade de fruits", ...
"Recettes" + TAB + "Entrées", aPremier)
Syntaxe
<Résultat> = ArbreDéplaceElément(<Champ Arbre> , <Élément source> , <Élément destination> [, <Mode de tri>])
<Résultat> : Booléen - Vrai si l'élément a été déplacé,
- 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) à déplacer. 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 déplacé. 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 déplacé 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 déplacé est inséré suivant l'ordre alphabétique, parmi les éléments du même niveau. | | aDernier | L'élément est déplacé à la dernière place du niveau. | | aPremier | L'élément est déplacé à la première place du niveau. | aTriAlpha
(Valeur par défaut) | L'élément déplacé est trié suivant l'ordre alphabétique, parmi les éléments du même niveau. |
Remarques Déplacer un élément sur lui-même Il est impossible de déplacer un élément sur lui-même ou sur un de ses fils. Dans ce cas, la fonction ArbreDéplaceElément retourne Faux et l'élément n'est pas déplacé. Doublons Si l'<Elément destination> contient déjà un fils du même nom que l'<élément source>, deux cas peuvent se présenter : - Si les doublons sont acceptés (constante aAccepteDoublon), le déplacement est effectué normalement. La fonction ArbreDéplaceElément retourne Vrai.
- Si les doublons ne sont pas acceptés, la fonction ArbreDéplaceElément retourne Faux. L'élément n'est pas déplacé.
Si l'<élément source> contient des doublons avec identifiants, ces doublons sont déplacés en conservant 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…
|
|
|
|