DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs
  • Connaître la valeur renvoyée par une fenêtre fille
  • Limites
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
La propriété ValeurRenvoyée permet de :
  • Connaître et modifier la valeur renvoyée par une fenêtre, une page ou un état.
  • Connaître et modifier la valeur renvoyée par une option d'un champ Sélecteur.
WINDEV Rappel : Une fenêtre ouverte par la fonction Ouvre peut renvoyer un résultat lors de sa fermeture. Cette valeur est renvoyée :
  • soit par le mot-clé Renvoyer présent dans le code de fermeture de la fenêtre,
  • soit par la fonction Ferme,
    Remarque : La fonction Ferme permet de renvoyer plusieurs valeurs.
  • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de la fenêtre.
WEBDEV - Code Serveur Rappel : Une page ouverte par la fonction PageAfficheDialogue peut renvoyer un résultat lors de sa fermeture. Cette valeur est renvoyée :
  • soit par le mot-clé Renvoyer présent dans le code de fermeture de la page,
  • soit par la fonction PageFermeDialogue,
  • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de la page,
  • soit par la fonction ContexteFerme.
Universal Windows 10 AppAndroidiPhone/iPadWidget IOS Utilisée sur le mot-clé MaFenêtreFille, la propriété ValeurRenvoyée permet de récupérer la valeur renvoyée par une fenêtre fille dans une application mobile.
WINDEVUniversal Windows 10 AppiPhone/iPadWidget IOS Rappel : Un état imprimé par la fonction iImprimeEtat peut renvoyer un résultat à la fin de son impression. Cette valeur est renvoyée :
  • soit par le mot-clé Renvoyer présent dans le code de fermeture de l'état,
  • soit par la propriété ValeurRenvoyée utilisée avant la fermeture de l'état.
WEBDEV - Code Navigateur La propriété ValeurRenvoyée permet de connaître et de modifier la valeur renvoyée par une popup utilisée par un champ Combo Popup.
Exemple
WINDEVJava
// Code permettant d'ouvrir la fenêtre "FEN_SaisieMotDePasse"
MonMotDePasse = Ouvre(FEN_SaisieMotDePasse)
SI MonMotDePasse <> "" ALORS
Info("Mot de passe incorrect")
FIN

// --------------------------------------------------------------------------------
// -- Code de clic sur le champ Bouton "OK" de la fenêtre "FEN_SaisieMotDePasse"
// L'utilisateur saisit son mot de passe dans le champ "SAI_MotDePasse"
// et valide la fenêtre
Ferme()

// --------------------------------------------------------------------------------

// -- Code de fermeture de la fenêtre
FEN_SaisieMotDePasse.ValeurRenvoyée = SAI_MotDePasse
Universal Windows 10 AppAndroidiPhone/iPadWidget IOS
// Evénement "Fermeture d'une fenêtre fille de FEN_Liste_Clients"
// -------------------------------------------------------------
// Actualise la liste des clients
ZoneRépétéeAffiche(ZR_Clients, taRéExécuteRequete)

// Pour tout retour (sauf la suppression)
SI MaFenêtreFille.ValeurRenvoyée <> -1 ALORS
nIndice est un entier
// Recherche la ligne du client
nIndice = ZoneRépétéeCherche(ATT_NumClient, Client.NumClient)
SI nIndice > 0 ALORS
// Positionne sur la ligne du client
ZoneRépétéePosition(ZR_Clients, nIndice)
FIN
FIN
Syntaxe

Connaître la valeur renvoyée Masquer les détails

<Résultat> = <Elément manipulé>.ValeurRenvoyée
<Résultat> : Tout type
Valeur qui sera renvoyée :
  • à la fermeture de la fenêtre, page ou état en cours.
  • si l'option du sélecteur est sélectionnée.
<Elément manipulé> : Nom de fenêtre, nom de page, nom d'état, nom d'option
Nom de l'élément manipulé :
  • Nom de la fenêtre, de la page, de l'état ou de l'état interne manipulé. Cette fenêtre/page/état doit être ouvert.
  • Nom de l'option du sélecteur. Ce nom est de la forme : <Champ Sélecteur>[<Numéro de l'option>].

Modifier la valeur renvoyée Masquer les détails

<Elément manipulé>.ValeurRenvoyée = <Nouvelle valeur>
<Elément manipulé> : Nom de fenêtre, nom de page, nom d'état, nom d'option
Nom de l'élément manipulé :
  • Nom de la fenêtre, de la page ou de l'état manipulé. Cette fenêtre/page/état doit être ouvert.
  • Nom de l'option du sélecteur. Ce nom est de la forme <Champ Sélecteur>[<Numéro de l'option>].
<Nouvelle valeur> : Tout type
Nouvelle valeur à renvoyer. Les types suivants peuvent être utilisés :
  • structure
  • structure dynamique
  • classe
  • type avancé
  • tableau
  • tableau associatif
  • file
  • pile
  • liste
Remarques
Universal Windows 10 AppAndroidiPhone/iPadWidget IOS

Connaître la valeur renvoyée par une fenêtre fille

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 l'événement "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 l'événement "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

Limites

La propriété ValeurRenvoyée s'applique :
  • WINDEVUniversal Windows 10 AppAndroidWidget AndroidJava aux fenêtres,
  • WEBDEV - Code Serveur aux pages,
  • WINDEVUniversal Windows 10 AppAndroidJava aux options des champs Sélecteur.
  • WINDEV aux fenêtres internes uniquement si elles sont ouvertes avec la fonction Ouvre.
  • WINDEVEtats et RequêtesUniversal Windows 10 AppiPhone/iPadWidget IOS aux états.
  • WINDEVEtats et RequêtesUniversal Windows 10 AppiPhone/iPadWidget IOS aux états internes (en lecture uniquement).
  • WEBDEV - Code Navigateur aux popups utilisées via un champ Combo Popup.
Liste des exemples associés :
Calendrier Popup Exemples unitaires (WINDEV) : Calendrier Popup
[ + ] Utilisation d'un calendrier utilisable avec la fonction OuvrePopup.
La fenêtre PopCalendrier s'avère très utile dans des applications contenant des champs date.
En effet, la fenêtre PopCalendrier permet de choisir une date visuellement.

Le risque d'erreur est diminué puisque l'utilisateur voit le jour de la semaine correspondant à la date sélectionnée.
Le champ date est alors renseigné par la valeur retournée par la fenêtre PopCalendrier.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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