PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Créer un état sur une vue HFSQL
  • Imprimer un état sur une vue HFSQL
  • Pour imprimer un état sur une vue HFSQL
  • Exemple WINDEV
  • Exemple Windows Mobile
  • Exemple WEBDEV
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Etat sur une vue HFSQL
HFSQLHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Présentation
Un état sur une vue HFSQL permet d'imprimer des enregistrements provenant d'une vue HFSQL Classic ou Client/Serveur.
Rappel : Une vue HFSQL correspond à une "image mémoire" de tout ou partie d'un fichier de données. Une vue est stockée en mémoire, ce qui la rend insensible aux modifications effectuées sur le fichier de données associé. Une fois créée, une vue se manipule comme un fichier de données HFSQL. Pour plus de détails, consultez Les vues HFSQL.
Versions 18 et supérieures
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
Versions 21 et supérieures
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
Caractéristiques d'un état sur une vue HFSQL :
  • un état sur une vue HFSQL est lié au fichier de base de cette vue HFSQL. L'état permet d'imprimer les enregistrements provenant de ce fichier de base.
  • l' ordre d'impression des enregistrements correspond à l'ordre des enregistrements présents dans la vue HFSQL (défini lors de la création de la vue ou avec la fonction HTrieVue).
La création d'un état sur une vue HyperFileSQL s'effectue grâce à l'assistant de création d'un état (option "Fichier .. Nouveau .. État").La création d'un état sur une vue HFSQL s'effectue grâce à l'assistant de création d'un état.
Lorsque l'état sur une vue HFSQL est créé, il est possible à tout moment de :
  • modifier la source de données de l'état (onglet "Données" de la description de l'état).
  • ajouter ou supprimer des champs Rubriques liés à la vue HFSQL associée à l'état.

Important

Le logiciel Etats & Requêtes ne permet pas de créer des états sur une vue HFSQL. Cependant, il est possible de personnaliser des états sur une vue HFSQL créés sous l'éditeur d'états intégré (couleur, polices, taille, ...).
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Créer un état sur une vue HFSQL
Pour créer un état sur une vue HFSQL :
  1. Sélectionnez l'option "Fichier .. Nouveau .. État". L'assistant de création d'un état s'affiche.Cliquez sur parmi les boutons d'accès rapide.
    • Dans la roue qui s'affiche, cliquez sur "Etat". 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 "Autre (programmation, fichier texte, zone mémoire, vue HyperFileSQL, ...").Sélectionnez la source de données de l'état (option "Autre (programmation, fichier texte, zone mémoire, vue HFSQL, ...").
  5. Sélectionnez le type de la source de données de l'état (option "d'une vue HyperFileSQL").Sélectionnez le type de la source de données de l'état (option "d'une vue HFSQL").
  6. Sélectionnez le fichier de données de base de la vue HFSQL associée à l'état.
  7. Sélectionnez les rubriques affichées dans l'état. Seuls les champs reliés aux rubriques de la vue HFSQL seront renseignés.
    Pour chaque rubrique affichée dans l'état :
    • saisissez le libellé correspondant. Ce libellé sera affiché :
      • soit avant la rubrique. 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 rubrique 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 la vue HFSQL associée à 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 (inutile dans ce type d'état).
  10. Selon le type d'état en cours de création, indiquez les options spécifiques correspondantes.
    Type d'étatOptions spécifiques
    État de type : Tableau + GrapheType du graphe, aspect du graphe, ...
    Options détaillées dans la page Etat Tableau + Graphe
    État de type GrapheType du graphe, aspect du graphe, ...
    Options détaillées dans la page Etat Graphe
    État sur formulaireImage du formulaire, impression de l'image du formulaire, ...
    Options détaillées dans la page Etat sur formulaire
    État ÉtiquetteFormat des étiquettes, nombre d'exemplaires identiques, ...
    Options détaillées dans la page Etat Étiquette

    Type d'étatOptions spécifiques
    État sur formulaireImage du formulaire, impression de l'image du formulaire, ...
    Options détaillées dans la page Etat sur formulaire
    État ÉtiquetteFormat 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.
    WINDEV 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 :
    • Versions 19 et supérieures
      Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
      Nouveauté 19
      Imprimer l'état sur plusieurs pages. Dans ce cas, l'utilisateur final devra assembler les pages. Pour plus de détails, consultez Impression multipage.
      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 une vue HFSQL

Pour imprimer un état sur une vue HFSQL

  1. Créer la vue HFSQL avec la fonction HCréeVue (ou la fonction HFusionneVue).
  2. Paramétrer la destination de l'impression de l'état :
    • WINDEV En WINDEV, grâce à la fonction iAperçu (aperçu avant impression, impression dans un fichier HTML, ...).
    • WEBDEV - Code Serveur En WEBDEV, grâce à la fonction iDestination (impression dans un fichier HTML, ...).
    • Windows Mobile En Windows Mobile, grâce à la fonction iConfigure ou iParamètre. Ces fonctions ouvrent une boîte de dialogue dans laquelle l'utilisateur sélectionne l'imprimante à utiliser par défaut.
      Pour plus de détails, consultez Modes d'impression d'un état.
  3. Préciser les paramètres suivants grâce à la fonction iImprimeEtat :
    • le nom de l'état à imprimer.
    • le nom de la vue HFSQL Classic utilisée.
Remarques :
  • La vue HFSQL doit avoir été créée et initialisée avant de lancer l'impression de l'état. Seule une vue HFSQL Classic ou Client/Serveur peut être utilisée.
  • 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 la vue HFSQL utilisée. Pour plus de détails, consultez Etat paramétré.
  • La propriété ..NomVue utilisée dans le code de l'état permet de connaître et de changer la vue HFSQL associée à l'état.
  • La propriété ..NomSource utilisée dans le code de l'état permet de connaître et de changer le fichier de données de base de la vue HFSQL associée à l'état.

Important

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 ou option "Code .. Tester l'état").soit en testant l'état (icône ).
Il n'est donc pas nécessaire de programmer l'impression de l'état.
WINDEVEtats et Requêtes

Exemple WINDEV

L'utilisateur sélectionne la référence d'une commande dans une liste. Le bouton "BTN_Imprimer" permet de :
  • créer la vue HFSQL "VueCommande" contenant les lignes de la commande sélectionnée (fonction HCréeVue).
  • ouvrir la fenêtre d'aperçu avant impression (fonction iAperçu).
  • imprimer l'état "ETAT_Vue" (fonction iImprimeEtat).
Dans cet exemple, le code de clic du bouton "BTN_Imprimer" est le suivant :
// Créer la vue
SI HCréeVue("VueCommande", LigneCde, "*", "Référence", "", "", ...
hVueExclusive + hVueInterruptible) = Faux ALORS
Erreur(HErreurInfo())
SINON
// Ouvrir la fenêtre d'aperçu
iAperçu()
// Imprimer l'état ETAT_Vue
iImprimeEtat(ETAT_Vue, "VueCommande")
FIN
Windows Mobile

Exemple Windows Mobile

L'utilisateur sélectionne la référence d'une commande dans une liste. Le bouton "BTN_Imprimer" permet de :
  • créer la vue HFSQL "VueCommande" contenant les lignes de la commande sélectionnée (fonction HCréeVue).
  • imprimer l'état "ETAT_Vue" (fonction iImprimeEtat).
Dans cet exemple, le code de clic du bouton "BTN_Imprimer" est le suivant :
// Créer la vue
SI HCréeVue("VueCommande", LigneCde, "*", "Référence", "", "", ...
hVueExclusive + hVueInterruptible) = Faux ALORS
Erreur(HErreurInfo())
SINON
// Sélectionner l'imprimante
iConfigure()
// Imprimer l'état ETAT_Vue
iImprimeEtat(ETAT_Vue, "VueCommande")
FIN
WEBDEV - Code Serveur

Exemple WEBDEV

L'internaute sélectionne la référence d'une commande dans une liste. Le bouton "BTN_Imprimer" permet de :
  • créer la vue HFSQL "VueCommande" contenant les lignes de la commande sélectionnée (fonction HCréeVue).
  • imprimer l'état "ETAT_Vue" dans un fichier PDF (fonction iImprimeEtat).
Dans cet exemple, le code de clic du bouton "BTN_Imprimer" est le suivant :
// Créer la vue
SI HCréeVue("VueCommande", LigneCde, "*", "Référence", "", "", ...
hVueExclusive + hVueInterruptible) = Faux ALORS
Erreur(HErreurInfo())
SINON
// Générer un nom de fichier unique
NomFicUnique est une chaîne = fRepWeb() + "\" + "ETAT_Vue_" + ...
DateSys() + HeureSys() + ".pdf"
// Paramétrer la destination de l'impression
iDestination(iPDF, NomFicUnique)
// Imprimer l'état ETAT_Vue
iImprimeEtat(ETAT_Vue, "VueCommande")
// Envoyer le fichier dans le navigateur
FichierAffiche(NomFicUnique, "application/pdf")
FIN
Liste des exemples associés :
WD Etats Exemples didactiques (WINDEV) : WD Etats
[ + ] Cet exemple montre les différentes méthodes pour réaliser un état :

- impressions basées sur différentes sources de données (requêtes, variables, ...)
- impressions basées sur des champs (Table, Tableur, TCD, ...)
- impression d'états composés
- impressions spécifiques (portrait / paysage, état avec filigrane, état avec code-barres, ...)
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire