DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Arbre
  • Noeud "frère"
  • Doublons
  • Format des images enroulées/déroulées
  • Type des images enroulées/déroulées
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
Insère une feuille à une position spécifique dans un champ Arbre. Cette insertion est effectuée par rapport à un élément "frère" existant.
Exemple de champ Arbre :
Vocabulaire lié à un champ Arbre
Exemple
// Insertion de la feuille "Gâteaux" au même niveau que
// la feuille "Glaces" dans le champ Arbre "ARBRE_RecetteTV"
// La feuille "Gâteaux" sera insérée avant la feuille "Glaces"
Res = ARBRE_RecetteTV.Insère("Recettes" + TAB + "Desserts" + TAB + "Glaces", ...
"Gâteaux", aDéfaut, aDéfaut, Null, aAvant)
Syntaxe
<Résultat> = <Champ Arbre>.Insère(<Chemin du noeud frère> , <Nom de la feuille> [, <Image enroulée> [, <Image déroulée> [, <Identifiant de la feuille> [, <Mode d'ajout> [, <Texte de la bulle d'aide>]]]]])
<Résultat> : Booléen
  • Vrai si la feuille a été insérée dans le champ Arbre,
  • Faux dans le cas contraire.
<Champ Arbre> : Nom de champ
Nom du champ Arbre à manipuler.
<Chemin du noeud frère> : Chaîne de caractères
Chemin complet du noeud "frère" de la feuille à insérer dans le champ Arbre. Ce noeud frère 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).
<Nom de la feuille> : Chaîne de caractères
Nom (libellé) de la feuille à insérer.
<Image enroulée> : Chaîne de caractères ou constante optionnelle
Image associée à l'élément inséré. Cette image est affichée lorsque l'élément est un noeud enroulé (voir Notes). En exécution, le libellé d'un noeud enroulé est précédé du signe "+".
Ce paramètre correspond :
  • soit au nom et au chemin complet (ou relatif) de l'image. Un chemin de type UNC peut être utilisé.
  • soit à la constante :
    aDéfaut
    (Valeur par défaut)
    Image par défaut (dossier fermé) :Dossier fermé
    NullAucune image
<Image déroulée> : Chaîne de caractères ou constante optionnelle
Image associée à l'élément inséré. Cette image est affichée lorsque l'élément est un noeud déroulé (voir Notes). En exécution, le libellé d'un noeud déroulé est précédé du signe "-".
Ce paramètre correspond :
  • soit au nom et au chemin complet (ou relatif) de l'image. Un chemin de type UNC peut être utilisé.
  • soit à la constante :
    aDéfaut
    (Valeur par défaut)
    Image par défaut (dossier ouvert) :Dossier ouvert
    NullAucune image
<Identifiant de la feuille> : Chaîne de caractères ou entier (optionnel)
Chaîne de caractères ou entier associé à l'élément inséré. Par défaut, ce paramètre correspond à une chaîne vide (""). Pour associer un identifiant à un élément déjà créé, utilisez la fonction <Arbre>.Modifie.
<Mode d'ajout> : Constante optionnelle
Position de la feuille insérée par rapport au noeud "frère" dans le champ Arbre.
aAprès
(Valeur par défaut)
La feuille insérée est placée après l'élément "frère" spécifié.
aAvantLa feuille insérée est placée avant l'élément "frère" spécifié.
<Texte de la bulle d'aide> : Chaîne de caractères optionnelle
Si ce paramètre est précisé, son contenu sera affiché lors du survol de l'élément dans une bulle d'aide. Par défaut, ce paramètre correspond à une chaîne vide. Si aucune bulle d'aide n'est associée à l'élément, la bulle d'aide associée au champ Arbre sera automatiquement affichée.
Remarques

Noeud "frère"

Si le noeud "frère" n'existe pas, l'insertion n'est pas effectuée : la fonction <Arbre>.Insère renvoie Faux.

Doublons

La fonction <Arbre>.Insère ne permet pas le contrôle de doublons lors de l'insertion d'un élément.
Pour gérer simplement les doublons, il est conseillé de gérer un identifiant spécifique pour identifier le niveau où l'insertion doit être effectuée. Pour plus de détails, consultez Gestion des doublons dans les champs Arbre.

Format des images enroulées/déroulées

WINDEV Les formats d'images supportés sous Windows sont :
  • Bitmap (*.BMP)
  • Graphics Interchange Format (*.gif)
  • Joint Picture Experts Group (*.jpg ; *.jpeg)
  • Kodak Photo CD (*.pcd)
  • PaintBrush (*.pcx)
  • Adobe Photoshop Format (*.psd)
  • TrueVision TARGA (*.tga)
  • Tagged Image File Format (*.tif ; *.tiff)
    Remarque : l'option "tiff mosaïque" de la norme tiff 6.0 n'est pas supportée. Dans ce cas, il est conseillé d'enregistrer l'image à la norme tiff 5.0.
  • Portable Network Graphics (*.png)
  • Windows MetaFiles (*.emf ; *.wmf)
  • Icônes (*.ico ; *.icw)
    Remarques :
    • Affichage HQ (Haute Qualité) disponible.
    • Gestion des planches au format BMP transparent (32 bits).
  • Curseurs (*.cur)
  • Portable Document Format (*.pdf)
  • Scalable Vector Graphics (*.svg)
  • Images WINDEV (générées par l'éditeur d'images, *.WDPIC).
WEBDEV - Code Serveur Les formats d'images reconnus sont les suivants : GIF, JPEG, PNG ou SVG (selon le support des navigateurs).

Type des images enroulées/déroulées

Les images utilisées peuvent être :
L'image spécifiée est réduite proportionnellement à la taille 16 x 16 pixels : dans la majorité des cas, la hauteur de l'image correspond à la hauteur de la ligne du champ Arbre.
WEBDEV - Code Serveur Les images utilisées peuvent uniquement être des fichiers image. Ces fichiers doivent être présents dans le répertoire "<NomProjet>_WEB". Ces images ne sont pas transformées lors de l'enregistrement de la page. Il n'est pas nécessaire d'utiliser la fonction fRepWeb pour indiquer le chemin de l'image. Ce chemin est relatif au répertoire "<NomProjet>_WEB".
Remarque : Il est conseillé d'utiliser des images 16 x 16 pixels (taille des petites icônes).
Composante : wd300obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 15/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale