PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Traitement "Ouverture" de l'état
  • Exécution du traitement
  • Mot de passe du fichier de données source de l'état
  • Initialisation des variables
  • Exemples d'utilisation
  • Traitement "Lecture des données"
  • Exécution du traitement
  • États basés sur un fichier texte
  • Exemples d'utilisation
  • Traitement "Filtre (tenir compte de l'enregistrement ?)"
  • Exécution du traitement
  • Utilisation du traitement Filtre
  • Exemples d'utilisation
  • Traitement "Fermeture" de l'état
  • Exécution du traitement
  • Exemples d'utilisation
  • Traitement "Avant réimpression" de l'état
  • Exécution du traitement
  • Exemples d'utilisation
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
Présentation
Les différents traitements associés aux états sont les suivants (ordre d'apparition sous l'éditeur de code) :
Plusieurs traitements sont associés aux états. Ces traitements sont exécutés lors de l'impression de l'état.
Pour connaître l'ordre d'exécution de ces traitements, consultez Enchaînement des traitements associés aux états.
Traitement "Ouverture" de l'état

Exécution du traitement

Le traitement "Ouverture" de l'état est exécuté lors du lancement de l'impression de l'état.
Rappel : L'ordre d'exécution des traitements au lancement d'un état (y compris lors d'un test) est le suivant :

Mot de passe du fichier de données source de l'état

Si le fichier de données source de l'état est protégé par un mot de passe, précisez ce mot de passe avant l'ouverture du fichier de données (grâce à la fonction HPasse par exemple).
Si le fichier de données n'a pas été ouvert avant l'impression de l'état, il est possible de préciser le mot de passe dans le traitement "Ouverture" de l'état.
WINDEVEtats et Requêtes

Initialisation des variables

Lors de l'impression d'un état depuis l'aperçu avant impression, l'état est automatiquement ré-exécuté lorsque :
  • l'utilisateur change d'imprimante.
  • l'utilisateur utilise un des boutons de la barre de boutons (Impression en mode PDF, HTML, dans un email, ...).
Dans ce cas, les données imprimées dans l'état peuvent être différentes de celles visualisées dans l'aperçu.
Il est conseillé d'initialiser les variables nécessaires à l'état dans le traitement "Ouverture de l'état" plutôt que dans le code du bouton qui lance l'impression.

Exemples d'utilisation

Ce traitement permet par exemple de :
  • déclarer les variables globales de l'état.
  • modifier les bornes de l'état avec les propriétés ..BorneMin et ..BorneMax.
  • initialiser les mots de passe des fichiers de données si nécessaire.
  • paramétrer la destination de l'impression (fonction iAperçu).
  • passer des paramètres à la requête liée à l'état (fonction iInitRequêteEtat).
  • récupérer les paramètres passés à l'état.
  • changer la source de données de l'état.
Remarque : La fonction iImprime ne doit pas être utilisée dans le traitement d'ouverture de l'état.
Traitement "Lecture des données"

Exécution du traitement

Ce traitement est exécuté lors du parcours des enregistrements à imprimer (dans la boucle d'impression), après la lecture de l'enregistrement.

États basés sur un fichier texte

Pour les états basés sur un fichier texte (avec lecture programmée), le traitement "Lecture des données" permet de lire les enregistrements présents dans le fichier texte pour les imprimer.

Exemples d'utilisation

Ce traitement permet par exemple de :
  • effectuer des substitutions de blocs (car le prochain enregistrement à imprimer est connu).
  • sélectionner des enregistrements.
  • effectuer des calculs spécifiques.
Remarque : Ce code renvoie Vrai s'il reste des enregistrements à imprimer et Faux s'il n'y a plus d'enregistrements à imprimer.
Pour ne pas imprimer un enregistrement, utilisez le traitement "Filtre (tenir compte de l'enregistrement ?)".
Traitement "Filtre (tenir compte de l'enregistrement ?)"

Exécution du traitement

Ce traitement est exécuté :
  • lors de l'initialisation de la source de données si elle est effectuée (pour les états basés sur un fichier, une vue ou une zone mémoire).
  • dans la boucle d'impression, après la lecture de l'enregistrement (cas des états sur requête ou sur table).
Ce traitement permet de filtrer les enregistrements affichés dans l'état.

Utilisation du traitement Filtre

Si ce traitement contient des lignes de code, ces lignes de codes doivent renvoyer une valeur :
  • Annuler pour arrêter la lecture des enregistrements (et arrêter l'impression).
  • Vrai pour signifier que l'enregistrement vérifie le filtre et qu'il doit être imprimé.
  • Faux pour signifier que l'enregistrement ne vérifie pas le filtre et qu'il ne doit pas être imprimé.

Exemples d'utilisation

Ce traitement permet par exemple de :
  • sélectionner des enregistrements.
  • réaliser des calculs avancés (total préalable, ...) pour les états basés sur les fichiers, les vues ou les zones mémoires.
Traitement "Fermeture" de l'état

Exécution du traitement

Ce traitement est exécuté lorsque l'impression de l'état est terminée, juste avant de fermer l'état.
Ce traitement ne doit pas contenir de fonctions d'impression.
Versions 21 et supérieures
Remarque : La fonction iFichierEnCours permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).
Nouveauté 21
Remarque : La fonction iFichierEnCours permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).
Remarque : La fonction iFichierEnCours permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).

Exemples d'utilisation

Ce traitement permet par exemple de :
  • connaître l'état de l'impression en cours (fonction iStatusImpressionEtat).
  • ouvrir une boîte de dialogue.
Versions 21 et supérieures
WINDEVEtats et Requêtes
Traitement "Avant réimpression" de l'état

Exécution du traitement

Ce traitement est exécuté lors d'une impression effectuée depuis l'aperçu avant impression (impression directe ou export dans les formats PDF, XLS, RTF, ...).
Ce traitement est exécuté après le traitement "Ouverture de l'état".
Si ce traitement renvoie :
  • Vrai, la réimpression sera effectuée.
  • Faux, la réimpression sera annulée.
Remarques :
  • La fonction iDestination utilisée dans ce traitement permet de connaître la destination de l'état (HTML, PDF, ...).
  • La fonction iFichierEnCours utilisée dans ce traitement permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).

Exemples d'utilisation

Ce traitement permet par exemple de :
  • demander la qualité du PDF généré avant l'export au format PDF.
  • ajouter un filigrane.
  • demander un mot de passe avant l'impression ou l'export.
Nouveauté 21
WINDEVEtats et Requêtes
Traitement "Avant réimpression" de l'état

Exécution du traitement

Ce traitement est exécuté lors d'une impression effectuée depuis l'aperçu avant impression (impression directe ou export dans les formats PDF, XLS, RTF, ...).
Ce traitement est exécuté après le traitement "Ouverture de l'état".
Si ce traitement renvoie :
  • Vrai, la réimpression sera effectuée.
  • Faux, la réimpression sera annulée.
Remarques :
  • La fonction iDestination utilisée dans ce traitement permet de connaître la destination de l'état (HTML, PDF, ...).
  • La fonction iFichierEnCours utilisée dans ce traitement permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).

Exemples d'utilisation

Ce traitement permet par exemple de :
  • demander la qualité du PDF généré avant l'export au format PDF.
  • ajouter un filigrane.
  • demander un mot de passe avant l'impression ou l'export.
WINDEVEtats et Requêtes
Traitement "Avant réimpression" de l'état

Exécution du traitement

Ce traitement est exécuté lors d'une impression effectuée depuis l'aperçu avant impression (impression directe ou export dans les formats PDF, XLS, RTF, ...).
Ce traitement est exécuté après le traitement "Ouverture de l'état".
Si ce traitement renvoie :
  • Vrai, la réimpression sera effectuée.
  • Faux, la réimpression sera annulée.
Remarques :
  • La fonction iDestination utilisée dans ce traitement permet de connaître la destination de l'état (HTML, PDF, ...).
  • La fonction iFichierEnCours utilisée dans ce traitement permet de connaître le nom du fichier généré pour l'état (cas des exports en PDF, HTML, ...).

Exemples d'utilisation

Ce traitement permet par exemple de :
  • demander la qualité du PDF généré avant l'export au format PDF.
  • ajouter un filigrane.
  • demander un mot de passe avant l'impression ou l'export.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Il devrait y avoir des exemples....
... ou un lien vers des exemples
MH
03 déc. 2017