DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Arbre
  • Déplacer un élément sur lui-même
  • Doublons
  • Ordre de priorité pour le tri
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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.
Exemple de champ Arbre :
Vocabulaire lié à un champ Arbre
Exemple
// 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.
aAccepteDoublonLes 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.
aDernierL'élément est déplacé à la dernière place du niveau.
aPremierL'é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 : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale