|
|
|
|
|
|
|
|
- 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
gValeurMémorisée (Fonction) En anglais : gStoredValue
// 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. 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"))
La fonction gValeurMémorisée est utilisée pour gérer les champs de type "Combo auto-alimentée". Lorsqu'un élément est récupéré dans un champ Combo ou Liste, l'ordre de priorité est le suivant : - Valeurs ajoutées par gValeurMémorisée.
- 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. 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 : - une chaîne vide ("") dans le cas d'un champ Combo,
- 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 : wd280obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|