DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Arbre
  • Copier 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
Copie un élément (feuille ou noeud) dans un champ Arbre. Toutes les branches issues de cet élément sont également copiées.
Exemple de champ Arbre :
Vocabulaire lié à un champ Arbre
Exemple
// 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.
aAccepteDoublonLes 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.
aDernierL'élément est copié à la dernière place du niveau.
aPremierL'é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 : 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