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
  • 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
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
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.
WEBDEV - Code Navigateur 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.
WINDEVWEBDEV - Code ServeurJavaAjax

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
WINDEVWEBDEV - Code ServeurJavaAjax

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 :
WINDEVWEBDEV - Code ServeurJavaAjax

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 :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
WINDEVWEBDEV - Code ServeurJavaAjax

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>)
WINDEVJavaAjax

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>
    WEBDEV - Code ServeurWEBDEV - Code Navigateur 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()
    WEBDEV - Code Navigateur La fonction <Arbre>.Select est disponible en code Navigateur.
  • l'identifiant de l'élément sélectionné, utilisez la fonction <Arbre>.RécupèreIdentifiant.
    WEBDEV - Code Navigateur 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
WINDEVWEBDEV - Code ServeurJavaAjax

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.
WINDEVWEBDEV - Code ServeurJavaAjax

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
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