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
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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).
Un champ peut être lié à une rubrique d'un fichier de données de base, ou à une rubrique d'un fichier de données relié (on parle alors de liaison complexe ou de liaison muti-fichiers de données). Exemple de liaison multi-fichier de données :
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 données de base>.<Rubrique de base>"
  • Liaison complexe avec une rubrique d'un fichier de données :
    "<Fichier de données de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

    où <Liaison> correspond à :
    <Fichier de données 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 données de base>.<Rubrique de base>"
  • Liaison complexe avec une rubrique d'un fichier de données :
    "<Fichier de données de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

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

    avec <Liaison> = <Fichier de données relié>.<Clé>:<Rubrique affichée> [<[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.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/05/2025

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