DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Page
  • Passer des paramètres à une page lors de son ouverture
  • Pour passer des paramètres à une page lors de son ouverture :
  • Tester une page 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
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
Page paramétrée
Passer des paramètres à une page lors de son ouverture

Pour passer des paramètres à une page lors de son ouverture :

1. Déclarez une procédure dans l'événement "Déclarations globales" de la page. Le nom de cette procédure doit être identique au nom de la page. Les paramètres de cette procédure correspondent aux paramètres à passer à la page.
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 page PAGE_CALENDRIER permet de gérer la sélection d'une date dans un calendrier. Cette page attend un paramètre indiquant la date à sélectionner.
// -- Déclarations globales PAGE_CALENDRIER --
 
PROCÉDURE PAGE_Calendrier(sDateSel)
// sDateSel : date précisant la date à sélectionner.
Ce paramètre est ensuite manipulable depuis n'importe quel événement de la page (bouton, procédures locales, ...).
Par exemple, dans l'événement "Initialisation" de la page PAGE_CALENDRIER :
// -- Initialisation PAGE_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 page lors de son ouverture (fonction PageAffiche, PageUtilise, ...). Par exemple, le bouton BTN_CALENDRIER permet d'ouvrir la page PAGE_CALENDRIER. Lors de l'ouverture de cette page, la date du jour est passée en paramètre.
// -- Code de clic du bouton BTN_CALENDRIER --
 
// Ouverture de la page PAGE_CALENDRIER
// Passage de la date du jour en paramètre
PageAffiche(PAGE_CALENDRIER, DateDuJour())
Tester une page paramétrée
Pour tester une page paramétrée :
  1. Ouvrez la page paramétrée sous l'éditeur de pages.
  2. Cliquez sur l'icône (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 page. Pour utiliser la valeur par défaut du ou des paramètres, saisissez le caractère "*".
  4. Validez. La page s'affiche selon la ou les valeurs spécifiées.
Notes

Paramètres passés par valeur

Si les paramètres passés à une page sont modifiés dans cette page, ces modifications seront prises en compte uniquement dans cette page. La valeur de ces paramètres n'est pas modifiée dans l'événement 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 page PAGE_CALENDRIER. Le paramètre sDateSel contient la valeur de la variable MaDate.
  3. La valeur du paramètre sDateSel est modifiée dans la page PAGE_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 l'événement "Déclarations globales" de la page PAGE_CALENDRIER :
// -- Déclarations globales de la page PAGE_CALENDRIER --
 
PROCÉDURE PAGE_Calendrier(sDateSel = 20030101)
// sDateSel : date précisant la date à sélectionner.

Portées des paramètres

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

Dernière modification : 13/04/2023

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