• Recevoir des paramètres à son ouverture.
• Renvoyer des valeurs à sa fermeture.

• fenêtres "calendrier" (fixer une date par défaut à l'ouverture et renvoyer une date sélectionnée à la fermeture),
• fenêtres de recherche,
• fenêtres de login renvoyant le mot de passe saisi, ...

• Le passage de paramètres à une fenêtre,
• Le renvoi d'une valeur lors de la fermeture d'une fenêtre,
• Le test d'une fenêtre paramétrée.

Passage de paramètres : cas général

1. Déclarez une procédure dans l'événement "Déclarations globales" de la fenêtre. Le nom de cette procédure doit être identique au nom de la fenêtre. Les paramètres de cette procédure correspondent aux paramètres à passer à la fenêtre.
   Attention : La déclaration de la procédure (mot-clé PROCEDURE) doit correspondre à la première ligne de l'événement "Déclarations globales".
   Par exemple, la fenêtre FEN_Calendrier permet de gérer la sélection d'une date dans un calendrier. Cette fenêtre attend un paramètre indiquant la date à sélectionner.
   
   // -- Déclarations globales de FEN_Calendrier
    
   PROCÉDURE FEN_Calendrier(sDateSel)
   //  sDateSel : date à sélectionner
   
   Ce paramètre est ensuite manipulable depuis n'importe quel événement de la fenêtre (code d'un bouton, procédures locales, etc.).
   Par exemple, dans l'événement "Initialisation" de la fenêtre FEN_Calendrier :
   
   // -- Initialisation de FEN_Calendrier
    
   // Le champ SAI_ChampDate est un champ de saisie
   // Il contient la valeur du paramètre sDateSel
   SAI_ChampDate = sDateSel
2. Passez le paramètre attendu par la fenêtre lors de son ouverture (fonctions Ouvre, OuvreFenêtreMobile, OuvreFille, OuvreSoeur, MDIOuvre). Par exemple, le bouton BTN_Calendrier permet d'ouvrir la fenêtre FEN_Calendrier. Lors de l'ouverture de cette fenêtre, la date du jour est passée en paramètre.
   
   // -- Code de clic du bouton BTN_Calendrier
    
   // Ouverture de la fenêtre FEN_Calendrier
   // Passage de la date du jour en paramètre
   Ouvre(FEN_Calendrier, DateDuJour())

Paramètres passés par valeur

1. La variable MaDate est déclarée dans le code du bouton BTN_Calendrier. Cette variable contient la date du jour (par exemple : MaDate = DateDuJour()).
2. Cette variable est passée en paramètre à la fenêtre FEN_Calendrier. Le paramètre sDateSel contient la valeur de la variable MaDate.
3. La valeur du paramètre sDateSel est modifiée dans la fenêtre FEN_Calendrier (par exemple : sDateSel = "20020701").
4. La valeur de la variable MaDate n'est pas modifiée.

Donner une valeur par défaut aux paramètres dans la déclaration

Portées des paramètres

1. Utilisez la propriété ValeurRenvoyée dans les traitements faisant appel à la fonction Ferme.
   Par exemple, dans la fenêtre FEN_Calendrier, le bouton BTN_OK et le bouton BTN_ANNULER ferment la fenêtre après avoir initialisé la valeur à renvoyer :
   
   // -- Clic sur bouton BTN_OK (fenêtre FEN_Calendrier)
    
   // L'utilisateur a cliqué sur OK,
   // la date saisie dans le champ SAI_ChampDate est renvoyée
   MaFenêtre.ValeurRenvoyée = SAI_ChampDate
   // Fermeture de la fenêtre
   Ferme()
   
   
   // -- Clic sur bouton BTN_ANNULER (fenêtre FEN_Calendrier)
    
   // L'utilisateur a cliqué sur BTN_ANNULER,
   // une chaîne vide est renvoyée
   MaFenêtre.ValeurRenvoyée = ""
   // Fermeture de la fenêtre
   Ferme()
   
   Il est également possible d'utiliser la propriété ValeurRenvoyée dans l'événement "Fermeture" de la fenêtre :
   
   // -- Code de fermeture de la fenêtre FEN_Calendrier
    
   // La date est saisie dans le champ SAI_ChampDate
   SI SAI_ChampDate = "" ALORS
   // Aucune date saisie
   MaFenêtre.ValeurRenvoyée = ""
   SINON
   // Une date est saisie
   MaFenêtre.ValeurRenvoyée = SAI_ChampDate
   FIN
2. Récupérez dans une variable la valeur renvoyée par la fenêtre lors de sa fermeture. Cette variable contient le résultat de la fonction Ouvre.
   Par exemple, le bouton BTN_Calendrier permet d'ouvrir la fenêtre FEN_Calendrier. Lors de l'ouverture de cette fenêtre (fonction Ouvre), la date du jour est passée en paramètre. La valeur renvoyée par la fenêtre lors de sa fermeture correspond au résultat renvoyé par la fonction Ouvre. Ce résultat est récupéré dans la variable DateRésultat :
   
   // -- Clic sur bouton BTN_Calendrier
   // Ouverture de la fenêtre FEN_Calendrier
   // DateRésultat est une variable chaîne contenant
   // la valeur renvoyée par la fenêtre FEN_Calendrier
   DateRésultat = Ouvre(FEN_Calendrier, DateDuJour())
    
   // Analyse du résultat renvoyé par la fenêtre
   SI DateRésultat = "" ALORS
   Info("Aucune date n'a été sélectionnée.")
   SINON
   Info("Date sélectionnée : " + DateVersChaîne(DateRésultat, maskDateSystème))
   FIN

1. Ouvrez la fenêtre paramétrée sous l'éditeur de fenêtres : sous le volet "Accueil", dans le groupe "Général", cliquez sur "Ouvrir".
2. Cliquez sur parmi les boutons d'accès rapide (ou appuyez sur la touche F9). La fenêtre suivante apparaît :
   
3. Spécifiez la valeur du ou des paramètres à utiliser pour le test de la fenêtre. Pour utiliser la valeur par défaut du ou des paramètres, saisissez le caractère "*".
4. Validez. La fenêtre s'affiche selon la ou les valeurs spécifiées.