PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • 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.
  • Versions 15 et supérieures
    avec plusieurs variables (dans ce cas, chaque variable peut être reliée à une propriété différente du champ).
    Nouveauté 15
    avec plusieurs variables (dans ce cas, chaque variable peut être reliée à une propriété différente du champ).
    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.
Versions 18 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Versions 26 et supérieures
Cette propriété est désormais disponible pour les Superchamps et les modèles de champs.
Nouveauté 26
Cette propriété est désormais disponible pour les Superchamps et les modèles de champs.
Cette propriété est désormais disponible pour les Superchamps et les modèles de champs.
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>"
  • Versions 15 et supérieures
    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>
    Nouveauté 15
    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>
    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.
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire