DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Sources de données
  • Présentation
  • Créer un état sur un champ Table hiérarchique depuis l'éditeur d'états
  • Créer un état sur un champ Table hiérarchique depuis l'éditeur d'états
  • Caractéristiques de l'état sur un champ Table hiérarchique
  • Test de l'état
  • Imprimer un état sur un champ Table hiérarchique
  • Imprimer un état sur un champ Table hiérarchique
  • Exemple WINDEV
  • Exemple WEBDEV
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
Etat sur un champ Table hiérarchique
Présentation
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.
Un état sur un champ Table hiérarchique peut imprimer :
  • 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.
Remarque : Seul un état de type Tableau hiérarchique peut être créé sur un champ Table hiérarchique.
Créer un état sur un champ Table hiérarchique depuis l'éditeur d'états
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.
Après avoir créé l'état, l'impression de l'état nécessite une programmation en WLangage. Pour plus détails, consultez le paragraphe Imprimer un état sur un champ Table hiérarchique.
Le logiciel Etats & Requêtes ne permet pas de créer des états sur un champ Table hiérarchique. Cependant, il est possible de personnaliser des états sur un champ Table hiérarchique créés sous l'éditeur d'états intégré (couleur, polices, taille, ...).

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.
    WINDEV 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.
Caractéristiques de l'état sur un champ Table hiérarchique
Un état sur un champ Table hiérarchique correspond à un état sur un champ table avec quelques caractéristiques supplémentaires.
L'état est donc constitué d'un tableau. Pour plus de détails sur la manipulation d'un tableau dans un état, consultez :
Dans la description de l'état, il est possible de paramétrer des informations spécifiques à ce type d'état dans l'onglet "Données" :
  • WINDEV 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

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 :
    • WINDEV En WINDEV, grâce à la fonction iDestination (visualisateur de rapports, impression dans un fichier HTML, ...).
    • WEBDEV - Code Serveur 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.
Remarques :
  • 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é.
  • WINDEV 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
  • WINDEV 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.
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.
WINDEV

Exemple WINDEV

L'ensemble des informations à imprimer est contenu dans le champ Table hiérarchique "TABLEH_TableClient" présent dans la fenêtre "FEN_Client".
L'état à imprimer est nommé "ETAT_TableH_Client" et s'imprime lors d'un clic sur le bouton "BTN_Imprimer".
Dans cet exemple, le code de clic du bouton "BTN_Imprimer" est le suivant :
// Ouvrir le visualisateur de rapports
iDestination(iVisualisateur)
// Imprimer l'état basé sur le champ Table hiérarchique "TABLEH_TableClient"
iImprimeEtat(ETAT_TableH_Client)
WEBDEV - Code Serveur

Exemple WEBDEV

L'ensemble des informations à imprimer est contenu dans le champ Table hiérarchique "TABLEH_TableClient" présent dans la page "PAGE_Client".
L'état à imprimer est nommé "ETAT_TableH_Client" et s'affiche dans un fichier PDF lors d'un clic sur le bouton "BTN_Imprimer".
Dans cet exemple, le code de clic du bouton "BTN_Imprimer" est le suivant :
// Génère un nom de fichier unique
NomFicUnique est une chaîne = fRepWeb() + "\" + "ETAT_TableH_Client_" + DateSys() + HeureSys() + ".pdf"
// Paramètre la destination de l'impression
iDestination(iPDF, NomFicUnique)
// Imprime l'état basé sur le champ Table hiérarchique TABLEH_TableClient
iImprimeEtat(ETAT_TableH_Client)
// Affiche l'état au format PDF
FichierAffiche(NomFicUnique, "application/pdf")
// Supprime le fichier
fSupprime(NomFicUnique)
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

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