L'état sur un champ Table hiérarchique permet d'imprimer directement les informations affichées dans un champ Table hiérarchique présent  :

• dans une fenêtre ou une page de l'application. Cette fenêtre ou page doit être affichée lors de l'impression de l'état.
• dans une fenêtre interne ou une page interne :
  • La fenêtre affichant la fenêtre interne doit être affichée.
  • La page affichant la page interne doit être affichée.

• soit toutes les lignes affichées dans le champ Table hiérarchique.
• soit uniquement les lignes sélectionnées par l'utilisateur (cas des champs Table hiérarchique multisélection où les lignes sont sélectionnées grâce à la touche Ctrl). Cette option n'est pas disponible en WEBDEV.
• soit la hiérarchie entière.
• soit uniquement la hiérarchie visible dans le champ Table hiérarchique.

L'éditeur d'états permet de créer un état de type Tableau hiérarchique basé sur un champ Table hiérarchique. Chaque ligne et chaque colonne du champ Table hiérarchique sont affichées dans l'état Tableau hiérarchique.

Créer un état sur un champ Table hiérarchique depuis l'éditeur d'états

Pour créer un état sur un champ Table hiérarchique depuis l'éditeur d'états :

1. Cliquez sur parmi les boutons d'accès rapide.
   • La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Etat" puis sur "Etat".
   • L'assistant de création d'un état s'affiche.
2. Choisissez un état de type "Tableau hiérarchique".
3. Sélectionnez "D'un champ Table hiérarchique" et passez à l'étape suivante.
4. Indiquez :
   • le champ Table hiérarchique sur lequel sera basé l'état. Seuls les champs Table hiérarchique présents dans les fenêtres ou les pages du projet en cours sont proposés.
   • si seules les lignes sélectionnées doivent être imprimées ou si toutes les lignes du champ doivent être imprimées.
5. Sélectionnez les rubriques (colonnes du champ Table hiérarchique) à imprimer et leur position (bloc associé).
6. Indiquez si des calculs doivent être réalisés sur les rubriques numériques.
7. Spécifiez le format de la feuille sur laquelle l'état va être imprimé. Par défaut, l'état est imprimé sur une feuille au format A4.
8. Sélectionnez le gabarit à utiliser.
9. Saisissez le nom et le titre de l'état (nom du fichier ".WDE" correspondant à l'état). Ce nom permettra d'identifier l'état dans vos programmes.
   Il est également possible d'indiquer si l'état peut être modifié par l'utilisateur final sous le logiciel "Etats et Requêtes".
10. Validez la création de l'état.
11. L'éditeur d'états propose automatiquement de changer le format de l'état utilisé.
12. Indiquez le mode de réduction de l'état :
    • Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
    • Utiliser le mode paysage.
    • Réduire l'état par rapport à l'original. Attention : selon le pourcentage de réduction choisi, l'état imprimé pourra devenir illisible.
13. L'état en cours de création s'affiche sous l'éditeur d'états.

Un état sur un champ Table hiérarchique correspond à un état sur un champ table avec quelques caractéristiques supplémentaires.

• Description d'un tableau d'un état.
• Manipuler les cellules d'un tableau d'un état.

• Lignes imprimées : Comme pour le champ Table, il est possible d'indiquer si seules les lignes sélectionnées ou l'ensemble des lignes du champ doivent être imprimées.
• Impression de la hiérarchie : Il est possible de spécifier si seule la hiérarchie affichée dans le champ doit être imprimée ou si la hiérarchie complète doit être imprimée.

Test de l'état

Il est impossible de tester un état sur un champ Table hiérarchique directement depuis l'éditeur d'états car la fenêtre ou la page contenant le champ Table hiérarchique doit être ouverte. Pour tester un état sur un champ Table hiérarchique, il est donc nécessaire de :

• créer si nécessaire un bouton dans la fenêtre ou la page du champ Table hiérarchique. Ce bouton permet de lancer l'impression de l'état sur le champ Table hiérarchique (fonction iImprimeEtat).
  Cas des fenêtres internes ou des pages internes : Si le champ Table hiérarchique est présent dans une fenêtre interne ou une page interne, il est conseillé de créer le bouton dans la fenêtre/page interne et non dans la fenêtre/page hôte.
• tester directement la fenêtre contenant le champ Table hiérarchique puis l'état (grâce au bouton).
  Cas des fenêtres internes : il est nécessaire d'effectuer le test depuis la fenêtre accueillant la fenêtre interne.
• tester directement la page contenant le champ Table hiérarchique puis l'état (grâce au bouton).
  Cas des pages internes : il est nécessaire d'effectuer le test depuis la page accueillant la page interne.

Imprimer un état sur un champ Table hiérarchique

L'impression d'un état sur un champ Table hiérarchique doit être réalisée uniquement à partir de la fenêtre (ou de la page) affichant le champ Table hiérarchique à imprimer. Il suffit de :

1. Créer un bouton dans la fenêtre (ou la page) contenant le champ Table hiérarchique.
2. Paramétrer la destination de l'impression de l'état :
   • En WINDEV, grâce à la fonction iDestination (visualisateur de rapports, impression dans un fichier HTML, ...).
   • En WEBDEV, grâce à la fonction iDestination (impression dans un fichier HTML, ...).
     Pour plus de détails, consultez Modes d'impression d'un état.
   Pour plus de détails, consultez Modes d'impression d'un état.
3. Préciser le nom de l'état à imprimer grâce à la fonction iImprimeEtat.

• Si des paramètres supplémentaires doivent être passés à l'état, ces paramètres doivent être indiqués dans la fonction iImprimeEtat, après le nom de l'état à imprimer. Pour plus de détails, consultez Etat paramétré.
• Si la fenêtre contenant le champ Table hiérarchique source de l'état est ouverte plusieurs fois (ouverture non modale par la fonction OuvreFille), il faut passer en paramètre à l'état le nom complet du champ Table hiérarchique à imprimer. Par exemple :
  
  // Propriété NomComplet va contenir le nom de la fenêtre
  // qui doit être ouverte avec un alias afin de distinguer chaque fenêtre
  iImprimeEtat(ETAT_TableH_Client, TABLEH_TableClient.NomComplet)
  // Code d'ouverture de l'état :
  PROCÉDURE ETAT_TableH_Client(NomTableHSource)
  MonEtat.NomSource = NomTableHSource
• La propriété SélectionSeule permet de connaître et de modifier les enregistrements à imprimer dans l'état : impression de tous les enregistrements ou uniquement des enregistrements sélectionnés.
• La propriété ConserverHiérarchieVisible permet de connaître et de modifier le mode d'impression de la hiérarchie : impression de la hiérarchie complète ou impression de la hiérarchie visible dans le champ.