DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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

Exécution de l'événement

L'événement "Ouverture" de l'état est exécuté lors du lancement de l'impression de l'état.
Rappel : L'ordre d'exécution des événements 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 l'événement "Ouverture" de l'état.

Exemples d'utilisation

Cet événement 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 iDestination).
  • 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 l'événement "Ouverture" de l'état.
Evénement "Lecture des données"

Exécution de l'événement

Cet événement 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), l'événement "Lecture des données" permet de lire les enregistrements présents dans le fichier texte pour les imprimer.

Exemples d'utilisation

Cet événement 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 : Cet événement 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 l'événement "Filtre (tenir compte de l'enregistrement ?)".
Evénement "Filtre (tenir compte de l'enregistrement ?)"

Exécution de l'événement

Cet événement 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 de données, 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 un champ Table).
Cet événement permet de filtrer les enregistrements affichés dans l'état.

Utilisation de l'événement Filtre

Si cet événement 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

Cet événement 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 de données, les vues ou les zones mémoires.
Evénement "Fermeture" de l'état

Exécution de l'événement

Cet événement est exécuté lorsque l'impression de l'état est terminée, juste avant de fermer l'état.
Cet événement ne doit pas contenir de fonctions d'impression.
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

Cet événement permet par exemple de :
  • connaître l'état de l'impression en cours (fonction iStatusImpressionEtat).
  • ouvrir une boîte de dialogue.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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