|
|
|
|
|
|
|
|
|
|
- Place de gLien
- 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
gLien (Fonction) En anglais : gLink
 Avertissement
A partir de la version 27, cette fonction est conservée par compatibilité. Il est conseillé d'utiliser la fonction gValeurMémorisée.
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 gLien soit active : Dans ce cas, le champ renverra directement la valeur de gLien correspondant à l'option sélectionnée.
ListeAjoute(COMBO_Civilité, "Monsieur" + gLien("1"))
Info(COMBO_Civilité[COMBO_Civilité].ValeurMémorisée)
Syntaxe
<Résultat> = gLien(<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 gLien La fonction gLien peut être appelée à n'importe quelle place dans la ligne à ajouter. Par exemple :
ListeAjoute(COMBO_COMBO1, gLien("1") + "Monsieur")
ListeAjoute(COMBO_COMBO1, "Monsieur" + gLien("1"))
Valeur ajoutée Lorsqu'une valeur est ajoutée par la fonction gLien, 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 gLien, seule la première valeur sera retournée.
ListeAjoute(LISTE_LISTE1, "MonElément" + gLien("Lien1") + gLien("Lien2"))
Dans cet exemple, seule la valeur "Lien1" sera retournée. La fonction ListeCherche tient compte des valeurs ajoutées par la fonction gLien. La fonction gLien n'est pas sensible à la casse (minuscules/majuscules). Ainsi le code suivant :
ListeAjoute(LISTE_LISTE1, "MonElément" + gLien("AAA"))
sera équivalent au code :
ListeAjoute(LISTE_LISTE1, "MonElément" + gLien("aaa"))
La fonction gLien 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 gLien.
- 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 gLien, le nom de la ressource obtenue par exemple avec la propriété RessourceSélectionnée correspondra à la valeur précisée dans la fonction gLien pour cette ressource. Exemple :
PlanningAjouteRessource(PLN_OccupationSalles, Reunion.Nom + gLien(Reunion.IDReunion))
...
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
Cas particulier : Champ Combo ou Combo dans un champ Table Si la fonction gLien 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" + gLien(""))
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 gLien 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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|