PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

PV

Accueil | Connexion | Français FR
  • Champ Etat Interne : état basé sur une requête paramétrée
  • Exécution d'une requête et état basé sur cette requête
  • Libération de la requête
  • Divers
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
Initialise la requête liée à l'état (cas d'une requête paramétrée). Cette fonction peut être appelée :
  • soit dans l'événement "Initialisation" de l'état,
  • soit avant la fonction iImprimeEtat.
Remarques :
  • Si l'état est lié à une requête non paramétrée, utilisez directement la fonction iImprimeEtat.
  • Si l'état est lié à une requête (paramétrée ou non) utilisant une connexion spécifique (connexion à une base de données par un provider OLE DB par exemple), utilisez la fonction iInitRequêteEtatConnexion.
  • Si l'état est inclus dans un état composite, la fonction iInitRequêteEtat doit obligatoirement être appelée dans l'événement "Initialisation" de l'état.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Imprimer sous Linux.

Important

Si la requête est créée avec le logiciel Etats & Requêtes, il n'est pas nécessaire d'utiliser la fonction iInitRequêteEtat pour spécifier les paramètres de la requête. En effet, si l'état sur une requête paramétrée est exécuté depuis le logiciel Etats & Requêtes, une fenêtre s'affiche permettant de saisir les paramètres de la requête.
Exemple
iInitRequêteEtat(ETAT_BulletinScolaire, "Dupond", "2020")
iImprimeEtat(ETAT_BulletinScolaire)
Syntaxe
iInitRequêteEtat(<Etat manipulé> [, <Paramètre 1 de la requête> [... [, <Paramètre N de la requête>]]])
<Etat manipulé> : Nom d'un état
Nom logique de l'état à imprimer.
<Paramètre 1 de la requête> : Type du paramètre de la requête (optionnel)
Premier paramètre de la requête définie comme source de l'état (si la requête attend un paramètre).
<Paramètre N de la requête> : Type du paramètre de la requête (optionnel)
Dernier paramètre de la requête définie comme source de l'état (si la requête attend un paramètre).
Remarques

Champ Etat Interne : état basé sur une requête paramétrée

Si l'état associé à un champ de type "Etat interne" est basé sur une requête paramétrée, utilisez la fonction iInitRequêteEtat pour passer les paramètres à la requête. Cette fonction doit être utilisée dans l'événement "Avant impression" du bloc contenant le champ "Etat Interne".
Pour plus de détails sur les "Etats Interne", consultez Champs de type Etat Interne.

Exécution d'une requête et état basé sur cette requête

Lors de l'impression d'un état basé sur une requête, si la requête a déjà été exécutée, elle n'est pas ré-exécutée. Pour forcer la ré-exécution de la requête (ajout d'enregistrements par exemple), il suffit d'utiliser les fonctions HExécuteRequête ou iInitRequêteEtat.

Libération de la requête

Lors de l'impression d'un état basé sur une requête initialisée avec la fonction iInitRequêteEtat, la requête est libérée à la fin de l'impression de l'état (comportement identique à l'appel de la fonction HAnnuleDéclaration).

Divers

  • Si certains paramètres attendus par la requête ne sont pas précisés (valeur correspondant à NULL par exemple), les conditions de sélection correspondant à ces paramètres seront ignorées.
  • Si le nombre de paramètres précisés dans la fonction iInitRequêteEtat est supérieur au nombre de paramètres attendus par la requête, les paramètres supplémentaires sont ignorés.
Classification Métier / UI : Code neutre
Composante : wd280etat.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire