• TableAjouteLigne, TableAjouteFils, TableInsèreLigne et TableInsèreFils : dans chaque ligne, la valeur de chaque colonne est séparée par des virgules.
• TableAjoute et TableInsère : dans une ligne, la valeur de chaque colonne est séparée par TAB.

Remarque : Pour optimiser le remplissage d'un champ Table hiérarchique, il est possible d'utiliser la propriété AjouteFilsDifféré sur les lignes du champ Table hiérarchique.
Dans ce cas, le principe du remplissage est simplifié :

• A l'initialisation du champ, seul les éléments du premier niveau sont chargés. Chaque élément est associé à la propriété AjouteFilsDifféré.
• Lorsque l'utilisateur clique sur l'élément de premier niveau pour le dérouler, la procédure définie par la propriété AjouteFilsDifféré est exécutée. Cette procédure effectue le remplissage du niveau à dérouler. La recherche des fils n'est effectuée que lorsque l'utilisateur demande à les voir.

Ajout de lignes dans un champ Table hiérarchique

• TableAjoute, TableAjouteLigne ou TableAjouteFils : ajoute une ligne à la fin du champ,
• TableInsère, TableInsèreLigne ou TableInsèreFils : ajoute une ligne à l'indice spécifié ou à l'indice en cours.

Remarque : Si l'option "Saisie en cascade" n'est pas sélectionnée :

• Le champ Table hiérarchique ne comporte aucune ligne à sa création. Dans ce cas, aucune saisie n'est possible. La propriété Vide est à Vrai.
• Pour insérer automatiquement une ligne dans un champ Table hiérarchique vide, utilisez la fonction TableAjoute ou TableAjouteLigne.

Modification d'une ligne ou d'une colonne

• par l'utilisateur, en saisissant directement dans les colonnes. Les modifications sont mémorisées automatiquement dans le champ Table hiérarchique, sans programmation complémentaire. La propriété Modifié est à Vrai.
• par programmation :
  • avec la fonction TableModifie ou la fonction TableModifieLigne pour modifier le contenu de la ligne en cours ou d'une ligne donnée.
    Par exemple :
    

    TableModifie(TABLEH_CLIENT, "PY" + TAB + "Jean" + TAB + "Nîmes")

    
    Remarque : Il est également possible d'utiliser directement le nom du champ Table hiérarchique :
    

    // Modifier la ligne en cours
    TABLEH_CLIENT = "DURAND" + TAB + "Sophie" + TAB + "Nîmes"
    // Modifier la colonne COL_JOUR de la ligne 3
    TableModifie(COL_JOUR, "Mercredi"+ TAB + "Vaqué", 3)

  • directement en donnant le nom de la colonne (comme pour un champ de saisie) pour modifier le contenu de la colonne. Pour modifier une colonne d'une ligne précise, il faut indiquer le numéro de la ligne (indice).
    Par exemple :
    

    COL_NOM[Indice] = NomClient

    
    Pour modifier une colonne de la ligne en cours, il n'est pas nécessaire de préciser l'indice.
    Par exemple :
    

    COL_NOM = NomClient

    
    La propriété Modifié est à Faux (elle est mise à Vrai uniquement par une saisie dans le champ Table hiérarchique).

Gestion des colonnes calculées

// COL_PHT : colonne calculée
// COL_PUHT et COL_QTE : colonnes liées à des zones mémoire
COL_PHT = COL_PUHT * COL_QTE

Suppression d'une ligne

• La syntaxe utilisée pour la fonction TableSupprime est :
  
  TableSupprime(Champ Table hiérarchique>[, <Indice>])
  
  Si l'indice est précisé, la fonction TableSupprime supprime la ligne correspondant à l'indice. Sinon, elle supprime la ligne en cours.
  La suppression d'une ligne du champ Table hiérarchique supprime toutes les valeurs des colonnes pour cette ligne.
• La syntaxe utilisée pour la fonction TableSupprimeFils est :
  
  TableSupprimeFils(<Champ Table hiérarchique>, <Indice de l'élément parent>)
  
  Tous les éléments fils de la ligne désignée par l'indice seront supprimés.

Sélection d'une ligne

Récupération d'une ligne ou d'une cellule

• soit la ligne entière.
• soit cellule par cellule.

Valeur d'une cellule de la ligne en cours

// COL_QTE est une colonne d'un champ Table hiérarchique
SI COL_QTE < 10 ALORS
	Info("Quantité insuffisante")
FIN

Valeur d'une cellule pour une ligne spécifique

// Totaliser le Prix PHT pour toutes les lignes de commande
PrixTotal = 0
POUR Indice = 1 À TABLEH_COMMANDE.Occurrence
	PrixTotal = PrixTotal + COL_PHT[Indice]
FIN

Contenu de la ligne en cours

Contenu d'une ligne spécifique

// Récupérer le contenu de la ligne 10 du champ Table hiérarchique TABLEH_CLIENT
LigneEnCours = TABLEH_CLIENT[10] 
// Nom du client sélectionné
NomClient = COL_NOM[TableSelect(TABLEH_CLIENT)]
// Récupérer le contenu de la ligne en cours du champ Table hiérarchique TABLEH_CLIENT
LigneEnCours = TABLEH_CLIENT

Enrouler tous les noeuds d'un champ Table hiérarchique

Dérouler tous les noeuds d'un champ Table hiérarchique

Remarque : Si le champ Table hiérarchique utilise le remplissage différé des sous-niveaux via la propriété AjouteFilsDifféré, la procédure de remplissage des sous-niveaux sera exécutée pour chaque nouvel élément déroulé.

Connaître le numéro de la ligne enroulée/déroulée

// Quelle est la ligne manipulée ? 
Info(TABLEH_TableHiérarchique[TABLEH_TableHiérarchique])

Définir le prochain état de la ligne ajoutée

// Les prochaines lignes ajoutées seront automatiquement enroulées
TABLEH_TableHiérarchique.Enroulé = Vrai

Connaître et modifier les images des lignes

• ImageDéroulée : image d'une ligne déroulée,
• ImageEnroulée : image d'une ligne enroulée.

// Modifier les images des lignes du champ Table hiérarchique
TABLEH_TableHiérarchique.ImageDéroulée = "DossierOuvert.gif"
TABLEH_TableHiérarchique.ImageEnroulée = "DossierFermé.gif"

Connaître le parent ou les fils d'un élément

• TableRécupèreParent : Renvoie le "parent" d'un élément, c'est-à-dire l'élément de niveau immédiatement supérieur.
• TableRécupèreFils : Renvoie les fils d'un élément, c'est-à-dire les éléments de niveau immédiatement inférieur.

• avec un champ Table hiérarchique, consultez Propriétés associées à un champ Table hiérarchique.
• avec les lignes d'un champ Table hiérarchique, consultez Propriétés associées à une ligne d'un champ Table hiérarchique