DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de manipulation des chaînes graphiques
  • Place de gValeurMémorisée
  • Valeur ajoutée
  • Sensibilité à la casse
  • Combos auto-alimentées
  • Élément récupéré
  • Champ Planning
  • Cas particulier : Champ Combo ou Combo dans un champ Table
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
Ajoute une valeur "invisible" dans un élément d'un champ Liste, Combo ou Planning. Cette valeur sera la valeur mémorisée lorsque l'utilisateur sélectionnera l'élément du champ.
Remarques :
  • Pour connaître la valeur mémorisée associée à un élément du champ, utilisez la propriété ValeurMémorisée.
  • Pour que la récupération de la valeur définie par la fonction gValeurMémorisée soit active :
    • soit utilisez la fonction gValeurMémoriséeActive.
    • WINDEVJava soit cochez l'option "Retourne la valeur spécifiée avec la fonction gValeurMémorisée" (onglet "Détail" de la description du champ).
    Dans ce cas, le champ renverra directement la valeur de gValeurMémorisée correspondant à l'option sélectionnée.
  • Cette fonction est identique à la fonction gLien.
Exemple
// Code du champ Bouton permettant de remplir le champ Combo
// ----------------------------------------------
// La combo "COMBO_Civilité" affiche les titres de civilité :
// "Monsieur", "Madame" et "Mademoiselle".
// Un entier représentant une civilité sera retourné au langage
ListeAjoute(COMBO_Civilité, "Monsieur" + gValeurMémorisée("1"))
// Seule la chaîne de caractères "1" est retournée au langage.
// Cette chaîne de caractères retournée n'est pas affichée dans le champ Combo.
// Code du champ Bouton permettant de connaître la valeur de gValeurMémorisée
// -------------------------------------------------------------------------------
// Code permettant d'obtenir la valeur du gValeurMémorisée de l'option sélectionnée 
Info(COMBO_Civilité[COMBO_Civilité].ValeurMémorisée)
// Affiche "1" dans notre exemple.
Syntaxe
<Résultat> = gValeurMémorisée(<Chaîne à retourner>)
<Résultat> : Chaîne de caractères
Chaîne de contrôle à utiliser dans les fonctions ListeAjoute, ListeInsère ou ListeModifie.
<Chaîne à retourner> : Chaîne de caractères
Valeur texte à retourner. Seule cette chaîne sera retournée au langage. Cette chaîne ne sera pas affichée dans la ligne.
Remarques

Place de gValeurMémorisée

La fonction gValeurMémorisée peut être appelée à n'importe quelle place dans la ligne à ajouter.
Par exemple :
ListeAjoute(COMBO_COMBO1, gValeurMémorisée("1") + "Monsieur")
// ou
ListeAjoute(COMBO_COMBO1, "Monsieur" + gValeurMémorisée("1"))

Valeur ajoutée

Lorsqu'une valeur est ajoutée par la fonction gValeurMémorisée, cette valeur n'est prise en compte ni dans le tri, ni pour les lettres d'appel.
Si plusieurs valeurs sont ajoutées dans un élément d'une liste avec gValeurMémorisée, seule la première valeur sera retournée.
ListeAjoute(LISTE_LISTE1, "MonElément" + gValeurMémorisée("Lien1") + gValeurMémorisée("Lien2"))
Dans cet exemple, seule la valeur "Lien1" sera retournée.
La fonction ListeCherche tient compte des valeurs ajoutées par la fonction gValeurMémorisée.

Sensibilité à la casse

La fonction gValeurMémorisée n'est pas sensible à la casse (minuscules/majuscules).
Ainsi le code suivant :
ListeAjoute(LISTE_LISTE1, "MonElément" + gValeurMémorisée("AAA"))
sera équivalent au code :
ListeAjoute(LISTE_LISTE1, "MonElément" + gValeurMémorisée("aaa"))

Combos auto-alimentées

La fonction gValeurMémorisée est utilisée pour gérer les champs de type "Combo auto-alimentée".

Élément récupéré

Lorsqu'un élément est récupéré dans un champ Combo ou Liste, l'ordre de priorité est le suivant :
  1. Valeurs ajoutées par gValeurMémorisée.
  2. Valeurs ajoutées par gARécupérer.
Pour connaître la valeur mémorisée associée à un élément du champ, utilisez la propriété ValeurMémorisée.

Champ Planning

Si les ressources du planning ont été créées avec la fonction PlanningAjouteRessource en utilisant la fonction gValeurMémorisée, le nom de la ressource obtenue par exemple avec la propriété RessourceSélectionnée correspondra à la valeur précisée dans la fonction gValeurMémorisée pour cette ressource.
Exemple :
// Ajoute une ressource (ici une salle de réunion) dans le champ Planning
// Reunion est le fichier de données qui décrit les différentes salles disponibles
PlanningAjouteRessource(PLN_OccupationSalles, Reunion.Nom + gValeurMémorisée(Reunion.IDReunion))

...

// Code de clic sur le bouton BTN_NOUVEAU_RDV
MonRDV est un RendezVous
SI PLN_OccupationSalles.RessourceSélectionnée = "" ALORS
RETOUR
FIN

MonRDV.DateDébut = PLN_OccupationSalles.DateDébut
MonRDV.DateFin = PLN_OccupationSalles.DateFin
MonRDV.Ressource = PLN_OccupationSalles.RessourceSélectionnée
// Le nom de la ressource correspond Ã  la valeur précisée 
// dans la fonction gValeurMémorisée pour cette ressource

Cas particulier : Champ Combo ou Combo dans un champ Table

Si la fonction gValeurMémorisée doit retourner une chaîne vide (""), le résultat obtenu est différent si le champ utilisé est un champ Combo ou une colone de type Combo dans une champ Table.
Ainsi, si le code suivant est utilisé :
ListeAjoute(COMBO, "MonElément" + gValeurMémorisée(""))
la valeur récupérée sera :
  1. une chaîne vide ("") dans le cas d'un champ Combo,
  2. 0 (zéro) dans le cas d'une colonne Combo d'un champ Table.
Pour conserver le même code de récupération de la valeur de gValeurMémorisée pour un champ Combo et une colonne Combo, il est conseillé d'utiliser un champ Combo placé dans une colonne de type conteneur du champ Table.
Composante : wd300obj.dll
Version minimum requise
  • Version 27
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