- 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
Gestion des doublons dans les champs Arbre
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. 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é. 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 :
| | | ArbreAjoute | Ajoute un élément "feuille" (et tous les noeuds nécessaires) dans un champ Arbre. | | ArbreInsère | Insère une feuille à une position spécifique dans un champ Arbre. | | ArbreModifie | Modifie un élément (noeud ou feuille) dans un champ Arbre. |
Exemple :
RésultatArbre est un booléen
RésultatArbre = ArbreAjoute(ARBRE_Arbre1, "Racine" + TAB + "Noeud" + TAB + "Feuille", ...
aDéfaut, aDéfaut, "Id feuille")
RésultatArbre = ArbreAjoute(ARBRE_Arbre1, "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 = ArbreAjoute(ARBRE_Arbre1, "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 ArbreRé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 :
| | | ArbreListeFils | Liste les "fils" d'un noeud et les éléments "fils" de ces "fils" dans un champ Arbre. | | ArbrePosition | Affiche 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. | | ArbreSelect | Renvoie le chemin complet de l'élément sélectionné dans un champ Arbre. |
Liste des exemples associés :
|
Exemples unitaires (WINDEV) : Le champ Arbre (Treeview)
[ + ] Utilisation du champ Arbre par programmation grâce aux fonctions Arbre du WLangage.
|
Documentation également disponible pour…
|
|
|
|