• 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 ou une page interne. La fenêtre (ou la page) affichant la fenêtre interne (ou la page interne) doit être affichée.

Le logiciel Etats & Requêtes ne permet pas de créer des états sur un champ Table. Cependant, il est possible de personnaliser des états sur un champ Table créés sous l'éditeur d'états intégré (couleur, polices, taille, ...).

• soit toutes les lignes affichées dans le champ Table (possibilité de filtrer les données du champ Table avec la loupe).
• soit uniquement les lignes sélectionnées par l'utilisateur (cas des champs Table multisélection où les lignes sont sélectionnées grâce à la touche Ctrl). Cette option n'est pas disponible en WEBDEV.

• Chaque ligne du champ Table correspond à un enregistrement.
• Chaque colonne du champ Table correspond à un champ Libellé (même les colonnes invisibles).
  Remarque : Les colonnes définies comme ne devant pas être imprimées (option "Export et impression" dans l'onglet "Général" de la description de la colonne) ne sont pas prises en compte.

Attention : Les données imprimées dans l'état sont triées selon la colonne de tri définie pour le champ Table.

Il est possible de créer un état sur un champ Table :

• soit depuis l'éditeur de fenêtres. L'état créé correspond alors à un état de type tableau.
• soit depuis l'éditeur d'états. L'assistant de création d'un état s'ouvre et permet de choisir le type d'état à créer (tableau, fiche, ...).

• modifier la source de données de l'état (onglet "Données" de la description de l'état).
• ajouter ou supprimer des champs Libellé liés au champ Table associé à l'état.

• créer si nécessaire un bouton dans la fenêtre ou la page du champ Table. Ce bouton permet de lancer l'impression de l'état sur le champ Table (fonction iImprimeEtat).
  Cas des fenêtres internes : Si le champ Table est présent dans une fenêtre interne, il est conseillé de créer le bouton dans la fenêtre interne et non dans la fenêtre hôte.
• tester directement la fenêtre ou la page contenant le champ Table 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.

Créer un état sur un champ Table 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 la présentation de votre état (tableau, fiche, étiquette, ...). Pour plus de détails, consultez Les différents types d'états.
3. Sélectionnez si nécessaire le modèle d'états à utiliser. Un modèle d'états permet de respecter une mise en page spécifique. Pour plus de détails sur les modèles d'états, consultez Les modèles d'états.
4. Sélectionnez la source de données de l'état (option "D'un champ Table ou Zone répétée").
5. Sélectionnez le champ Table sur lequel sera basé l'état. Seuls les champs Table et Zone répétée présents dans les fenêtres ou les pages du projet en cours sont proposés.
6. Pour imprimer :
   • toutes les lignes affichées dans le champ Table : sélectionnez l'option "Toutes les lignes du champ Table".
   • uniquement les lignes sélectionnées par l'utilisateur : sélectionnez l'option "Seulement les lignes sélectionnées dans le champ Table".
     Remarque : Ce choix pourra être modifié par programmation grâce à la propriété SélectionSeule.
7. Pour chaque colonne du champ Table affiché dans l'état :
   • indiquez si la colonne doit être imprimée ou non via la coche.
   • saisissez le libellé correspondant. Ce libellé sera affiché :
     • soit avant le champ. Par exemple :
       
       
     • soit dans l'entête de la colonne (cas des états Tableau). Par exemple :
       
       
       
       Ce libellé pourra être modifié directement sous l'éditeur d'états.
   • sélectionnez le bloc dans lequel le champ associé à la colonne du champ Table doit être imprimé. La position des différents champs pourra être modifiée directement sous l'éditeur d'états. Pour plus de détails sur les différents blocs et sur leur position dans un état, consultez Blocs d'un état.
8. Modifiez si nécessaire l'ordre d'affichage des différents champs dans l'état à l'aide des boutons fléchés à droite du tableau.
9. Si le champ Table associé à l'état contient au moins une rubrique de type numérique, il est possible de réaliser des calculs sur ces rubriques. Spécifiez le calcul réalisé pour chaque rubrique (somme, moyenne, ...). Deux types de calcul sont possibles :
   • calcul général : un champ Calculé sera créé dans le bloc Fin de document.
   • calcul sur rupture : un champ Calculé sera créé dans le bloc Bas de rupture. Dans les calculs sur rupture, le résultat du calcul est ré-initialisé à chaque rupture. Pour réaliser un calcul sur rupture, une rupture doit être présente dans l'état en cours de création.
10. Selon le type d'état en cours de création, indiquez les options spécifiques correspondantes.
    

    Type d'état	Options spécifiques
    État sur formulaire	Image du formulaire, impression de l'image du formulaire, ... Options détaillées dans la page Etat sur formulaire
    État Étiquette	Format des étiquettes, nombre d'exemplaires identiques, ... Options détaillées dans la page Etat Étiquette

11. 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.
    Remarque : Par défaut, les champs de l'état sont disposés sur une seule colonne. Pour réaliser un état multicolonne, il suffit de spécifier le nombre de colonnes voulues dans l'onglet "Format" de la fenêtre de description de l'état.
12. Sélectionnez le gabarit de l'état si nécessaire.
13. 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 & Requêtes".
14. Validez la création de l'état.
15. L'éditeur d'états propose automatiquement de changer le format de l'état utilisé si les conditions suivantes sont réunies :
    • l'état en cours de création comporte un tableau.
    • le format de l'état ne permet pas d'afficher l'ensemble des colonnes du tableau.
16. Si nécessaire, 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.
17. L'état en cours de création s'affiche sous l'éditeur d'états.

Imprimer un état sur un champ Table

1. Créer un bouton dans la fenêtre (ou la page) contenant le champ Table.
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.
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 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 à imprimer. Par exemple :
  
  // La 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_Table_Client, TABLE_Client.NomComplet)
  
  
  // Code d'ouverture de l'état :
  PROCÉDURE ETAT_Table_Client(NomTableSource)
  MonEtat.NomSource = NomTableSource
• 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.

Sous le logiciel Etats & Requêtes, il est possible d'imprimer un état :

• soit en lançant une impression (icône ).
• soit en testant l'état (icône ).

Il n'est donc pas nécessaire de programmer l'impression de l'état.