DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Arbre
  • Présentation
  • Principe
  • Mise en place
  • Définition d'un identifiant pour la gestion des doublons
  • Manipulation directe d'un élément à l'aide de son identifiant
  • Connaître l'identifiant d'un élément
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
Présentation
WINDEV, WINDEV Mobile et WEBDEV permettent d'ajouter des doublons dans les éléments d'un champ Arbre. Le mécanisme de gestion des doublons dans les champs Arbre permet de manipuler simplement ces doublons.
Principe
La gestion des doublons dans les champs Arbre est basée sur la gestion des identifiants pour chaque élément d'un arbre.
En effet, lors de l'ajout, de l'insertion ou de la modification d'un élément dans un champ Arbre, il est possible de préciser un identifiant pour l'élément manipulé. Cet identifiant (déterminé par le développeur) va permettre d'identifier de façon unique le doublon manipulé par l'utilisateur.
Le principe est simple : il suffit d'utiliser un identifiant différent par doublon. Cet identifiant sera ensuite récupéré par les différentes fonctions de gestion des arbres et permettra ainsi d'identifier correctement le doublon manipulé.
Mise en place

Définition d'un identifiant pour la gestion des doublons

La définition d'un identifiant se fait simplement lors de l'ajout ou de la modification d'un élément dans un champ Arbre.
Pour associer un identifiant à un élément d'un champ Arbre, il suffit de préciser cet identifiant dans les fonctions de programmation suivantes :
<Arbre>.AjouteAjoute un élément "feuille" (et tous les noeuds nécessaires) dans un champ Arbre.
<Arbre>.InsèreInsère une feuille à une position spécifique dans un champ Arbre.
<Arbre>.ModifieModifie un élément (noeud ou feuille) dans un champ Arbre.
Exemple :
RésultatArbre est un booléen
RésultatArbre = ARBRE_Arbre1.Ajoute("Racine" + TAB + "Noeud" + TAB + "Feuille", ...
aDéfaut, aDéfaut, "Id feuille")
RésultatArbre = ARBRE_Arbre1.Ajoute("Racine" + TAB + "Noeud" + TAB + "Feuille", ...
aDéfaut, aDéfaut, "Id feuille 2", aAccepteDoublon)

Manipulation directe d'un élément à l'aide de son identifiant

Pour manipuler un élément doublon, il est nécessaire de connaître et de préciser son identifiant.
Pour manipuler un élément dont on connaît le chemin, il suffit de compléter chaque élément du chemin si nécessaire par son identifiant en utilisant fonction ArbreID.
Exemple : Pour ajouter une feuille à l'élément "Racine"+TAB+"Noeud"+TAB+"Feuille" ayant pour identifiant "Id feuille", il suffit d'utiliser la syntaxe suivante :
RésultatArbre = ARBRE_Arbre1.Ajoute("Racine" + TAB + "Noeud" + TAB + "Feuille" + ...
ArbreID("Id Feuille") + TAB + "Mon Elément", aDéfaut, aDéfaut, "Mon Elément 1")
La fonction ArbreID peut également être utilisée avec la syntaxe <Nom de l'arbre> [ <Chemin de élément>].
Par exemple :
ARBRE_Arbre1["Racine" + TAB + "Noeud" + TAB + "Feuille" + ArbreID("Id Feuille") + ...
TAB + "Mon Elément"]..Couleur = RougeClair

Connaître l'identifiant d'un élément

Pour connaître l'identifiant d'un élément d'un arbre, il suffit d'utiliser la fonction <Arbre>.RécupèreIdentifiant.
Dans le cas de la gestion des doublons, l'identifiant fait partie intégrante du chemin, puisqu'il permet d'identifier l'élément sélectionné.
Les fonctions WLangage renvoyant le chemin d'un élément (lors de la sélection d'un élément par exemple) peuvent donc renvoyer :
  • soit le chemin de l'élément sans prendre en compte l'identifiant.
  • soit le chemin de l'élément en y incluant si nécessaire l'identifiant de chaque élément du chemin.
Les fonctions concernées sont les suivantes :
<Arbre>.ListeFilsListe les "fils" d'un noeud et les éléments "fils" de ces "fils" dans un champ Arbre.
<Arbre>.PositionAffiche un champ Arbre à partir d'un élément (noeud ou feuille) spécifié ou renvoie le nom du premier élément affiché dans un champ Arbre.
<Arbre>.SelectRenvoie le chemin complet de l'élément sélectionné dans un champ Arbre.
Liste des exemples associés :
Le champ Arbre (Treeview) Exemples unitaires (WINDEV) : Le champ Arbre (Treeview)
[ + ] Utilisation du champ Arbre par programmation grâce aux fonctions Arbre du WLangage.
Version minimum requise
  • Version 23
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