DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions d'impression
  • Initialisation des sources de données des états enchaînés
  • Gestion des numéros de pages
  • Utilisation de variables globales
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
Ajoute un état dans un enchaînement d'impressions d'états.
Remarque : L'enchaînement d'impressions d'états permet d'imprimer des états différents à la suite, visibles comme une seule impression dans le visualisateur de rapports. Il est possible d'ajouter divers types de documents dans cet enchaînement. Pour plus de détails, consulter Enchaîner des états.
Exemple
iDestination(iVisualisateur)
iEnchaînementAjoute(ETAT_Etat1)
iEnchaînementAjoute(ETAT_Etat2, 3)
iEnchaînementImprime()
// Ouvrir le visualisateur de rapports
iDestination(iVisualisateur)
POUR TOUT Activités
// Ajoute l'état des activités pour l'activité en cours
iEnchaînementAjoute(ETAT_Activités, Activités.IDActivités, Activités.IDActivités)
// Ajoute l'état du matériel correspondant à l'activité en cours
iEnchaînementAjoute(ETAT_MatérielEquipement, Activités.NomActivité)
FIN
iEnchaînementImprime()
Syntaxe
iEnchaînementAjoute(<Etat> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Etat> : Chaîne de caractères
Nom de l'état :
  • Nom logique de l'état, défini sous l'éditeur d'états.
  • Nom physique de l'état (avec son chemin), si le code compilé est intégré à l'état.
WEBDEV - Code Serveur Ce paramètre peut correspondre uniquement au nom logique de l'état.
<Paramètre 1> : Paramètres optionnels (le type correspond au type du paramètre)
Paramètre optionnel attendu par l'état pour son exécution. Ce paramètre a été défini dans le code d'ouverture de l'état. Ce paramètre peut être par exemple un nom de vue, de zone mémoire, etc.
Attention : Si l'état comprend des bornes (borne minimale et borne maximale), les deux premiers paramètres doivent correspondre respectivement à la borne minimale et à la borne maximale.
Attention : Ce paramètre est passé par valeur à l'état et non par adresse.
<Paramètre N> : Paramètres optionnels (le type correspond au type du paramètre)
Paramètre optionnel attendu par l'état pour son exécution. Ce paramètre a été défini dans le code d'ouverture de l'état. Ce paramètre peut être par exemple un nom de vue, de zone mémoire, etc.
Attention : Si l'état comprend des bornes (borne minimale et borne maximale), les deux premiers paramètres doivent correspondre respectivement à la borne minimale et à la borne maximale.
Attention : Ce paramètre est passé par valeur à l'état et non par adresse.
Remarques

Initialisation des sources de données des états enchaînés

Les états ne sont pas exécutés au moment de l'exécution de la fonction iEnchaînementAjoute : seul leur nom et leurs paramètres sont mémorisés.
Ces états sont réellement exécutés lors de l'appel de la fonction iEnchaînementImprime.
Attention : Si des états présents dans l'enchaînement sont basés sur une requête, l'initialisation de la requête doit être effectuée avec la fonction iInitRequêteEtat dans l'événement "Initialisation" de l'état (et non avant l'appel de la fonction iEnchaînementAjoute).

Gestion des numéros de pages

Si les états présents dans l'enchaînement affichent le numéro de page, les numéros de page se suivront pour les différents états enchaînés.
Par exemple, si le premier état de l'enchaînement est numéroté de 1 à 10, le second état sera numéroté de 11 à 20, et ainsi de suite.
Pour forcer le numéro de page d'un état de l'enchaînement, utilisez la fonction iNumPage dans l'état voulu.

Utilisation de variables globales

Les états enchaînées peuvent manipuler des variables globales dans les différents événements WLangage associés à l'état. Dans ce cas, la valeur de la variable globale prise en compte est celle correspondant à l'impression ou à la prévisualisation effective.
Si la valeur d'une variable globale est modifiée entre l'appel de la fonction iEnchaînementAjoute et la fonction iEnchaînementImprime, sa valeur dans l'état correspondra à la dernière valeur qui lui a été affectée.
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, ...)
Classification Métier / UI : Code neutre
Composante : wd290etat.dll
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Remettre les numéros de page à 1
entre 2 iEnchainementAjoute, on peut utiliser uniquement iRAZNbPages pour remettre à 1 le compteur de page ET le compteur total du nombre de pages.
Lionel
09 sep. 2019

Dernière modification : 21/06/2023

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