DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Blocs d'un état
  • Présentation
  • Evénements des blocs d'un état
  • Manipuler un bloc dans un événement ou traitement WLangage
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
Chaque bloc de l'état est associé à différents événements. Ces événements 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.
Evénements des blocs d'un état
Les événements associés aux blocs d'un état sont les suivants :
EvénementsConditions d'exécution
InitialisationExécuté lors de l'initialisation du bloc. L'ordre d'exécution des événements au lancement d'un état (y compris lors d'un test) est le suivant :
  • événement "Ouverture" de l'état.
  • événement "Initialisation" des blocs de l'état.
  • événement "Initialisation" des champs.
Cet événement permet par exemple de :
  • initialiser des champs "Calculé".
  • initialiser des variables globales déclarées dans l'événement "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 de l'événement "Avant impression" du bloc.
  • réalisation des calculs sur les champs du bloc.
Lorsque cet événement 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, l'événement "Avant impression de bloc" est exécuté avant de savoir si le bloc va pouvoir être imprimé sur la page.
Cet événement 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  : Cet événement 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.
Cet événement 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).
Valeur de rupture
(Bloc Haut de rupture uniquement)
Exécuté avant l'événement "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 événements 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 événements associés à un bloc de l'état sont exécutés lors de l'impression de ce bloc. Dans ces événements, vous pouvez utiliser du code WLangage. Pour plus de détails sur l'enchaînement de ces événements, consultez Enchaînement des événements associés à un état.
Manipuler un bloc dans un événement ou traitement WLangage
Pour manipuler un bloc d'un état dans un événement ou traitement WLangage, il est possible d'utiliser une des deux méthodes suivantes :
  • utiliser directement le nom de ce bloc. Cette syntaxe est valable uniquement si ce bloc est manipulé depuis l'état auquel il appartient.
  • 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

Dernière modification : 25/05/2022

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