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
  • Champ Liste image
  • Erreur d'affichage
  • 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é LiaisonFichier permet de connaître et de modifier la liaison d'un champ :
  • avec une rubrique d'un fichier de données.
  • avec une variable.
  • avec plusieurs variables (dans ce cas, chaque variable peut être reliée à une propriété différente du champ).
Rappel : La liaison d'un champ avec une rubrique ou une variable est normalement définie sous l'éditeur de fenêtres ou de pages, lors de la description du champ (onglet "Liaison"). Cette liaison permet d'indiquer la rubrique du fichier de données qui sera utilisée lors de l'utilisation des fonctions de synchronisation (EcranVersFichier, EcranVersSource, PageVersFichier, PageVersSource, FichierVersEcran, FichierVersPage, SourceVersEcran, SourceVersPage).
Exemple de liaison multi-fichiers :
Onglet 'Liaison' de la description d'un champ
Cette propriété est équivalente à la fonction ChampAlias.
Exemple
// Relie le champ SAI_Saisie1 avec la rubrique Nom du fichier de données Client
SAI_Saisie1.LiaisonFichier = "Client.Nom"
// Idem, mais à partir du fichier de données Commande avec 1 liaison
SAI_Saisie2.LiaisonFichier = "Commande.IDClient" + TAB + "Client.IDClient:Nom"
// Idem, mais à partir du fichier de données LigneCmd avec 2 liaisons
SAI_Saisie3.LiaisonFichier = "LigneCmd.IDCmd" + TAB + ...
"Commande.IDCmd:IDClient" + TAB + "Client.IDClient:Nom"
// Relie le champ Table TABLE_Table1 avec le tableau Tableau_Mois
TABLE_Table1.LiaisonFichier = ":Tableau_Mois"
// Mise à jour à l'écran
FichierVersEcran()
// A chaque appel de la fonction SourceVersEcran, le champ SAI_EnCours_Autorisé aura :
// - sa valeur affichée mise à jour par la propriété EnCoursAutorisé d'une instance de classe,
// - une couleur de fond affectée par la valeur d'une variable globale
gclContact est un cContact
gsCouleur est un entier = BleuPastel
SAI_EnCours_Autorisé.LiaisonFichier = ":gclContact.EnCoursAutorisé" + TAB + ...
"valeur" + RC + ":gsCouleur" + TAB + "CouleurFond"
// Mise à jour à l'écran
SourceVersEcran()
Syntaxe

Connaître la liaison d'un champ avec une rubrique ou une variable Masquer les détails

<Liaison actuelle> = <Champ manipulé>.LiaisonFichier
<Liaison actuelle> : Chaîne de caractères
Différents types de liaisons peuvent être trouvés :
  • Aucune liaison : chaîne vide ("")
  • Liaison simple avec une rubrique d'un fichier de données :
    "<Fichier de base>.<Rubrique de base>"
  • Liaison complexe avec une rubrique d'un fichier de données :
    "<Fichier de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

    où <Liaison> correspond à :
    <Fichier relié>.<Clé>:<Rubrique reliée>[<Indice>]
  • Liaison avec une variable :
    ":<préfixe><Nom de la variable>"
    ou bien
    ":<Nom de la variable>"
    (le préfixe est présent uniquement si la charte de programmation est activée dans le projet).
<Champ manipulé> : Nom de champ
Nom du champ dont on veut connaître la liaison fichier.

Modifier la liaison d'un champ avec une rubrique ou une variable Masquer les détails

<Champ manipulé>.LiaisonFichier = <Nouvelle liaison>
<Champ manipulé> : Nom de champ
Nom du champ dont on veut modifier la liaison fichier.
<Nouvelle liaison> : Chaîne de caractères
Différents types de liaisons peuvent être définis :
  • Aucune liaison : chaîne vide ("")
  • Liaison simple avec une rubrique d'un fichier de données :
    "<Fichier de base>.<Rubrique de base>"
  • Liaison complexe avec une rubrique d'un fichier de données :
    "<Fichier de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

    où <Liaison> correspond à :
    <Fichier relié>.<Clé>:<Rubrique reliée>[<Indice>]
    Remarque : la syntaxe suivante est également autorisée :
    <[Fichier de base>.<Rubrique>[<[Indice]>] [: <Liaison> [ : <Liaison>] ]

    avec <Liaison> = <Fichier relié>.<Clé>:<RubAff> [<[Indice]>]
  • Liaison avec une variable :
    ":<préfixe><Nom de la variable>"
    ou bien
    ":<Nom de la variable>"
    Le préfixe doit être précisé si la charte de programmation est activée dans le projet (que les préfixes soient affichés ou non).
  • Liaison avec une variable de type source de données :
    <Nom de la variable>.Nom + ".<Rubrique de base>"
  • Liaison de plusieurs propriétés avec plusieurs variables : la chaîne de caractères décrivant la liaison doit être de la forme :
    ":" + <Nom de la variable 1> + TAB + <Nom de la propriété 1> + RC + ...
    ":" + <Nom de la variable 2> + TAB + <Nom de la propriété 2> + RC + ...
    ":" + <Nom de la variable N> + TAB + <Nom de la propriété N>
Remarques
WINDEVJava

Champ Liste image

La propriété LiaisonFichier permet de connaître et de modifier la liaison des libellés d'un champ Liste image avec une rubrique d'un fichier de données.
WINDEVJava

Erreur d'affichage

La fonction ChampErreur permet de personnaliser le message d'erreur affiché dans les champs en cas d'impossibilité d'afficher la valeur du champ.

Limites

La propriété LiaisonFichier s'applique uniquement aux champs d'une fenêtre ou d'une page.
Widget Android Cette propriété s'applique uniquement aux champs suivants :
  • Champ Bouton.
  • Champ Libellé.
  • Champ Image.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/04/2023

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