Manipuler un élément d'un champ Arbre par programmation (syntaxe préfixée)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Arbre

Présentation
Manipuler directement les éléments d'un champ Arbre
Fonctions WLangage
Manipulation directe
Initialiser un élément d'un champ Arbre
Initialiser un élément
Associer une bulle d'aide à un élément
Sélectionner un élément dans un champ Arbre
Sélectionner l'élément de la ligne
Se positionner sur le dernier élément du champ Arbre
Récupérer l'élément sélectionné dans le champ Arbre
Propriétés WLangage associées aux élément d'un champ Arbre
Utilisation des propriétés sur un élément d'un champ Arbre
Exemples

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Manipuler un élément d'un champ Arbre par programmation (syntaxe préfixée)

Présentation

Cette page d'aide présente comment manipuler les éléments d'un champ Arbre aussi bien par les fonctions WLangage que par manipulation directe.

Il est ainsi possible de :

Manipuler un élément d'un champ Arbre,
Initialiser un élément d'un champ Arbre,
Sélectionner un élément dans un champ Arbre,
Récupérer l'élément sélectionné dans le champ Arbre,
Utiliser les propriétés WLangage sur un élément d'un champ Arbre.

Cette version permet uniquement de récupérer l'élément sélectionné dans un champ Arbre.

Manipuler directement les éléments d'un champ Arbre

Fonctions WLangage

Dans les fonctions WLangage de gestion des champs Arbre, l'élément du champ Arbre se manipule grâce à son chemin complet (depuis la racine du champ Arbre). Ce chemin est au format suivant :

"<Nom de la racine>" + TAB + ["<Nom du 1er noeud>" + TAB + ...
["<Nom du 2ème noeud>" + TAB + [...]]]"<Nom de la feuille>"

Les différents éléments constituant le chemin des chaînes de caractères sont séparés par des caractères TAB.

Manipulation directe

Pour manipuler directement un élément du champ Arbre (par exemple avec les propriétés WLangage), deux notations sont disponibles :

Manipulation grâce à l'indice de l'élément :
Il suffit d'utiliser la notation suivante : <Champ Arbre> [ <Indice de l'élément>].
Attention : Les indices spécifiés prennent uniquement en compte les éléments visibles.
Exemple : Modification de la couleur du 5ème élément affiché dans un champ Arbre :
ARBRE_MonArbre[5].Couleur = RougeClair
Manipulation grâce au chemin complet de l'élément :
Il suffit d'utiliser la notation suivante : <Champ Arbre> [ <Chemin de élément>].
Le chemin de l'élément est une chaîne de caractères de la forme :
"<Nom de la racine>" + TAB + ["<Nom du 1er noeud>" + TAB + ...
["<Nom du 2ème noeud>" + TAB + [...]]]"<Nom de la feuille>"
Exemple : Modification de la couleur de l'élément "Ananas".
ARBRE_MonArbre["Recette" + TAB + "Dessert" + TAB + "Ananas"].Couleur = RougeClair

Initialiser un élément d'un champ Arbre

Initialiser un élément

Pour initialiser un élément d'un champ Arbre, utilisez la fonction <Arbre>.Ajoute.

Lors de cet ajout, il est possible :

Associer une bulle d'aide à un élément

Pour associer une bulle d'aide à un élément d'un champ Arbre, il est possible d'utiliser :

soit les fonctions du WLangage permettant d'ajouter ou de modifier un élément d'un champ Arbre (<Arbre>.Ajoute, <Arbre>.Insère, <Arbre>.Modifie),
soit la propriété Bulle sur l'élément voulu.

Si le texte de la bulle d'aide de l'élément n'est pas précisé, le texte affiché sera celui de la bulle d'aide du champ Arbre (si il existe).

Rappel : Par défaut, la bulle d'aide associée aux différents champs est affichée. Pour choisir d'afficher ou non les bulles d'aide, utilisez la fonction BulleActive.

Sélectionner un élément dans un champ Arbre

Sélectionner l'élément de la ligne <Indice>

Pour sélectionner l'élément de la ligne <Indice>, utilisez :

soit l'affectation directe :
<Champ Arbre> = Indice

Si la ligne est affichée dans le champ Arbre, l'élément correspondant est sélectionné.
soit la fonction <Arbre>.SelectPlus :
<Champ Arbre>.SelectPlus(<Nom complet de l'élément>)

Se positionner sur le dernier élément du champ Arbre

Pour se positionner sur le dernier élément du champ Arbre, utilisez la propriété Occurrence :

<Champ Arbre> = <Champ Arbre>.Occurrence

Récupérer l'élément sélectionné dans le champ Arbre

Pour récupérer :

l'indice de l'élément sélectionné, utilisez la lecture directe de l'élément :
Indice = <Champ Arbre>
Cette fonctionnalité n'est pas disponible en WEBDEV.
le chemin complet de l'élément sélectionné, utilisez la fonction <Arbre>.Select :
<Chemin> = <Champ Arbre>.Select()
La fonction <Arbre>.Select est disponible en code Navigateur.
l'identifiant de l'élément sélectionné, utilisez la fonction <Arbre>.RécupèreIdentifiant.
La fonction <Arbre>.RécupèreIdentifiant n'est pas disponible en code Navigateur.

Propriétés WLangage associées aux élément d'un champ Arbre

Utilisation des propriétés sur un élément d'un champ Arbre

De nombreuses propriétés WLangage peuvent être utilisées sur les éléments d'un champ Arbre.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un élément d'un champ de type Arbre, consultez Propriétés associées à une ligne d'un champ Arbre.

Exemples

Exemple : Comment modifier la couleur d'un élément d'un champ Arbre :

ARBRE_MonArbre[5].Couleur = RougeClair

Exemple : Comment modifier la taille de la police d'un élément d'un champ Arbre :

ARBRE_MonArbre["Recette" + TAB + "Dessert" + TAB + "Ananas"].PoliceTaille = 14

Voir Aussi

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