PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Passer des paramètres à une fenêtre lors de son ouverture
  • Renvoyer une valeur lors de la fermeture d'une fenêtre
  • Tester une fenêtre paramétrée
  • Notes
  • Paramètres passés par valeur
  • Donner une valeur par défaut aux paramètres dans la déclaration
  • Portées des paramètres
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Fenêtre paramétrée
Présentation
Une fenêtre peut :
  • Recevoir des paramètres à son ouverture.
  • Renvoyer des valeurs à sa fermeture.
Cette fenêtre se comporte alors comme une procédure renvoyant ou non des valeurs.
Ce type de fenêtres peut être utile dans les cas suivants par exemple :
  • 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, ...
Cette page d'aide présente :
Versions 15 et supérieures
WINDEV MobileAndroid Les fenêtres paramétrées sont disponibles pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Les fenêtres paramétrées sont disponibles pour les applications Android.
WINDEV MobileAndroid Les fenêtres paramétrées sont disponibles pour les applications Android.
Versions 16 et supérieures
WINDEV MobileUniversal Windows 10 App Les fenêtres paramétrées sont disponibles pour les applications Windows Phone.
WINDEVLinux Les fenêtres paramétrées sont disponibles pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEV MobileUniversal Windows 10 App Les fenêtres paramétrées sont disponibles pour les applications Windows Phone.
WINDEVLinux Les fenêtres paramétrées sont disponibles pour les applications WINDEV sous Linux.
WINDEV MobileUniversal Windows 10 App Les fenêtres paramétrées sont disponibles pour les applications Windows Phone.
WINDEVLinux Les fenêtres paramétrées sont disponibles pour les applications WINDEV sous Linux.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Les fenêtres paramétrées sont disponibles pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Les fenêtres paramétrées sont disponibles pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Les fenêtres paramétrées sont disponibles pour les applications iPhone/iPad.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonctionnalité est désormais disponible en mode Universal Windows 10 App.
Passer des paramètres à une fenêtre lors de son ouverture
Pour passer des paramètres à une fenêtre lors de son ouverture :
1. Déclarez une procédure dans le traitement "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 du traitement "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

PROCEDURE FEN_Calendrier(sDateSel)
//  sDateSel : date à sélectionner
Ce paramètre est ensuite manipulable depuis n'importe quel traitement de la fenêtre (bouton, procédures locales, ...).
Par exemple, dans le traitement "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, 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.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())
Renvoyer une valeur lors de la fermeture d'une fenêtre
Pour renvoyer une valeur lors de la fermeture d'une fenêtre :
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()
// -- Code de clic du 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 le traitement "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 :
// -- Code de clic du 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
Le traitement du bouton BTN_Calendrier est stoppé jusqu'à la fermeture de la fenêtre FEN_Calendrier.
Versions 18 et supérieures
Universal Windows 10 AppAndroidiPhone/iPad Cas particulier : Valeur renvoyée par une fenêtre fille dans une application WINDEV Mobile
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFille (et non Ouvre).
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFille).
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFenêtreMobile (ou la fonction OuvreFille) et non la fonction Ouvre.
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFenêtreMobile ou la fonction OuvreFille).
Par exemple :
  • Dans le code de fermeture de la fenêtre fille, la fonction Ferme est utilisée pour renvoyer un paramètre :
    Ferme("", MonParamètre)
  • Dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre appelante, le nom de la fenêtre fille ainsi que la valeur renvoyée peuvent être récupérés en utilisant le mot-clé MaFenêtreFille :
    // Fermeture d'une fenêtre fille
    NomFenêtreFille = MaFenêtreFille..Nom
    ValeurFenêtreFille = MaFenêtreFille..ValeurRenvoyée
Nouveauté 18
Universal Windows 10 AppAndroidiPhone/iPad Cas particulier : Valeur renvoyée par une fenêtre fille dans une application WINDEV Mobile
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFille (et non Ouvre).
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFille).
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFenêtreMobile (ou la fonction OuvreFille) et non la fonction Ouvre.
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFenêtreMobile ou la fonction OuvreFille).
Par exemple :
  • Dans le code de fermeture de la fenêtre fille, la fonction Ferme est utilisée pour renvoyer un paramètre :
    Ferme("", MonParamètre)
  • Dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre appelante, le nom de la fenêtre fille ainsi que la valeur renvoyée peuvent être récupérés en utilisant le mot-clé MaFenêtreFille :
    // Fermeture d'une fenêtre fille
    NomFenêtreFille = MaFenêtreFille..Nom
    ValeurFenêtreFille = MaFenêtreFille..ValeurRenvoyée
Universal Windows 10 AppAndroidiPhone/iPad Cas particulier : Valeur renvoyée par une fenêtre fille dans une application WINDEV Mobile
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFille (et non Ouvre).
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFille).
Dans les applications mobiles, l'ouverture des fenêtres est effectuée par la fonction OuvreFenêtreMobile (ou la fonction OuvreFille) et non la fonction Ouvre.
Il est possible de connaître la valeur renvoyée par une fenêtre fille dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre ouvrant la fenêtre fille (celle qui a utilisé la fonction OuvreFenêtreMobile ou la fonction OuvreFille).
Par exemple :
  • Dans le code de fermeture de la fenêtre fille, la fonction Ferme est utilisée pour renvoyer un paramètre :
    Ferme("", MonParamètre)
  • Dans le traitement "Fermeture d'une fenêtre fille" de la fenêtre appelante, le nom de la fenêtre fille ainsi que la valeur renvoyée peuvent être récupérés en utilisant le mot-clé MaFenêtreFille :
    // Fermeture d'une fenêtre fille
    NomFenêtreFille = MaFenêtreFille..Nom
    ValeurFenêtreFille = MaFenêtreFille..ValeurRenvoyée
Tester une fenêtre paramétrée
Pour tester une fenêtre paramétrée :
  1. Ouvrez la fenêtre paramétrée sous l'éditeur de fenêtres (option "Fichier .. Ouvrir").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 l'icône "Go" dans la barre d'icônes de WINDEV (ou appuyez sur la touche [F9]). La fenêtre suivante apparaît :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.
Notes

Paramètres passés par valeur

Si les paramètres passés à une fenêtre sont modifiés dans cette fenêtre, ces modifications seront prises en compte uniquement dans cette fenêtre. La valeur de ces paramètres n'est pas modifiée dans le traitement appelant.
Par exemple :
  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

Il est possible de donner une valeur par défaut aux paramètres dans la déclaration des paramètres.
Par exemple, pour donner une valeur par défaut dans l'exemple précédent, saisissez le code suivant dans le traitement "Déclarations globales" de la fenêtre FEN_Calendrier :
// -- Déclarations globales de FEN_Calendrier

PROCEDURE FEN_Calendrier(sDateSel = "20030101")
//  sDateSel : date à sélectionner

Portées des paramètres

Les paramètres passés à une fenêtre sont globaux à tous les traitements de cette fenêtre (initialisation, code d'un bouton, code d'une procédure locale, ...).
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire