PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Place de gLien
  • Valeur ajoutée
  • Sensibilité à la casse
  • Combos auto-alimentées
  • Élément récupéré
  • Champ Planning
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
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 gLien soit active :
    • soit utilisez la fonction gLienActive.
    • WINDEVAndroidWidget AndroidWindows MobileJava soit cochez l'option "Retourne la valeur spécifiée avec la fonction gLien" (onglet "Détail" de la description du champ).
    Dans ce cas, le champ renverra directement la valeur de gLien correspondant à l'option sélectionnée.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
PHP Cette fonction est désormais disponible pour les sites PHP.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
PHP Cette fonction est désormais disponible pour les sites PHP.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Code du bouton permettant de remplir la 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" + gLien("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 la combo.
// Code du bouton permettant de connaître la valeur de gLien
// -----------------------------------------------------------
// Code permettant d'obtenir la valeur du gLien de l'option sélectionnée
Info(COMBO_Civilité[COMBO_Civilité]..ValeurMémorisée)
// Affiche "1" dans notre exemple.
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 (avec guillemets)
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")
OU
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.

Sensibilité à la casse

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"))

Combos auto-alimentées

La fonction gLien 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 gLien.
  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 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 :
// 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 + gLien(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 gLien pour cette ressource
Composante : wd250obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
glien() ne fonctionne pas sous android
Tests effectués avec l'option Détail>>Retourne la valeur spécifiée avec la fonction gLien", puis cette case désactivée, avec la fonction gLienActive(). Le résultat constaté est le même sous android :
La valeur retournée par COMBO_COMBO est celle du texte affiché, pas celle de la fonction glien().
COMBO_COMBO[COMBO_COMBO] renvoie une erreur fatale, en prenant comme indice de ligne la valeur de COMBO_COMBO.
Arbos
10 mar. 2019
[Attention] Exemple non fonctionnel
L'exemple suivant est FAUX :

// 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" + gLien("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 la combo.
// Code permettant d'obtenir la valeur du gLien de l'option sélectionnée
Info(COMBO_Civilité[COMBO_Civilité]..ValeurMémorisée)

La ligne "Info(COMBO_Civilité[COMBO_Civilité]..ValeurMémorisée)" ne fonctionne pas et peut renvoyer une erreur car combo_xx[combo_xx] (qui renvoie généralement la ligne selectionnée dans la combo) renvoie ici la valeur donnée au gLien.

Valentin BALDINI
19 juil. 2017