PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Traitements des blocs d'un état
  • Manipuler un bloc dans un traitement WLangage
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
Chaque bloc de l'état est associé à différents traitements. Ces traitements permettent d'affiner le fonctionnement de l'état grâce aux différents ordres de programmation du WLangage.
De plus, chaque bloc peut être lui-même manipulé en WLangage : il suffit d'utiliser le nom du bloc dans le code WLangage.
Traitements des blocs d'un état
Les traitements associés aux blocs d'un état sont les suivants :
TraitementsConditions d'exécution
InitialisationExécuté lors de l'initialisation du bloc. L'ordre d'exécution des traitements au lancement d'un état (y compris lors d'un test) est le suivant :
  • traitement "Ouverture" de l'état.
  • traitement "Initialisation" des blocs de l'état.
  • traitement "Initialisation" des champs.
Ce traitement permet par exemple de :
  • initialiser des champs "Calculé".
  • initialiser des variables globales déclarées dans le traitement "Ouverture" de l'état.
  • effectuer des substitutions de blocs.
Avant impressionAvant l'impression d'un bloc, les opérations suivantes sont réalisées :
  • lecture de l'enregistrement en cours.
  • affectation des valeurs lues dans les champs du bloc.
  • réalisation des calculs sur les valeurs des rubriques.
  • exécution du traitement "Avant impression" du bloc.
  • réalisation des calculs sur les champs du bloc.
Lorsque ce traitement est appelé, l'éditeur d'états s'est assuré qu'il reste assez de place sur la page en cours pour imprimer le bloc en cours (cas d'un bloc insécable). S'il n'y a pas assez de place pour imprimer le bloc insécable en cours, il y a passage à la page suivante (et impression des blocs Bas de page, Haut de page et Complément de corps si nécessaire).Lorsque ce traitement est appelé, l'éditeur d'états s'est assuré qu'il reste assez de place sur la page en cours pour imprimer le bloc en cours (cas d'un bloc insécable). S'il n'y a pas assez de place pour imprimer le bloc insécable en cours, il y a passage à la page suivante (et impression des blocs Pied de page, Entête de page et Complément de corps si nécessaire).
Si le bloc est auto extensible, le traitement "Avant impression de bloc" est exécuté avant de savoir si le bloc va pouvoir être imprimé sur la page.
Ce traitement permet par exemple de :
  • consulter et modifier les champs du bloc concerné.
  • affecter des images.
  • exécuter la fonction iTerminePage dans le bloc Haut de rupture.
Attention  : Ce traitement ne peut pas exécuter de substitution du bloc en cours. Il peut par contre demander la substitution d'un autre bloc.
Après impressionExécuté après l'impression du bloc.
Ce traitement permet par exemple de :
  • consulter et modifier les champs du bloc concerné.
  • affecter des images.
  • remettre à zéro les champs qui viennent d'être imprimés.
  • substituer les blocs (pris en compte pour les prochains blocs).
  • imprimer un bloc Itération (fonction iImprimeBloc).
Rupture ?
(Bloc Haut de rupture uniquement)
Exécuté avant le traitement "Avant impression" du bloc Haut de rupture.Exécuté avant le traitement "Avant impression" du bloc Fin de rupture.
Pour plus de détails sur les ruptures dans un état, consultez Rupture dans un état.
Rappel : Si la destination de l'impression est un fichier HTML, les blocs Haut de page et Bas de page ne sont édités qu'une seule fois.
Pour visualiser les traitements spécifiques à un bloc, utilisez :
  • soit l'option "Code du bloc" du menu contextuel du bloc (clic droit sur l'intitulé du bloc).
  • soit l'icône "Code" de la description du bloc.
Certaines fonctions et propriétés sont spécifiques à la manipulation des blocs.
Remarque : Les traitements associés à un bloc de l'état sont exécutés lors de l'impression de ce bloc. Dans ces traitements, vous pouvez utiliser du code WLangage. Pour plus de détails sur l’enchaînement de ces traitements, consultez Enchaînement des traitements associés à un état.
Manipuler un bloc dans un traitement WLangage
Pour manipuler un bloc d'un état dans un traitement WLangage, il suffit :
  • soit d'utiliser directement le nom de ce bloc. Cette syntaxe est valable uniquement si ce bloc est manipulé depuis l'état auquel il appartient.
  • soit d'utiliser la notation suivante : "<NomEtat>.<NomBloc>".
Un bloc peut être manipulé :
  • soit dans une fonction WLangage.
  • soit avec une propriété WLangage.
  • soit en affectation directe.
Par exemple :
// Imprimer un bloc d'itération
iImprimeBloc("ITERATION1")
// Rendre le bloc "Corps" invisible
Corps..Visible = Faux
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire