|
|
|
|
|
|
|
|
|
|
- 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
Evénements associés aux états
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. 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. 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|