PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 le code d'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.
  • Versions 16 et supérieures
    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.
    Nouveauté 16
    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.
    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.
Versions 15 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Imprimer sous Linux.
Nouveauté 15
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Imprimer sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Imprimer sous Linux.
Versions 18 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.

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", "1994")
iImprimeEtat(ETAT_BulletinScolaire)
Syntaxe
iInitRequêteEtat(<Nom de l'état> [, <Paramètre 1 de la requête> [... [, <Paramètre N de la requête>]]])
<Nom de l'état> : Chaîne de caractères (avec ou sans guillemets)
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.
Composante : wd240etat.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire