PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Lien d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données
  • Mise à jour des rubriques : Cas particuliers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
EcranVersFichier (Fonction)
En anglais : ScreenToFile
ODBCNon disponible avec ce type de connexion
Initialise automatiquement :
  • la valeur mémoire des rubriques d'un fichier de données avec la valeur des champs de la fenêtre ou de la page. Les rubriques du fichier de données de base reliées aux champs de la fenêtre sont automatiquement affectées avec les valeurs des champs correspondants (même si ces champs sont grisés, inactifs, ou invisibles).
  • la valeur des variables WLangage avec la valeur des champs de la fenêtre ou de la page. Les variables WLangage reliées aux champs de la fenêtre sont automatiquement affectées avec les valeurs des champs correspondants (même si ces champs sont grisés, inactifs, ou invisibles).
AndroidWidget AndroidJavaPHP Seule la liaison avec les rubriques d'un fichier de données est gérée. La liaison avec les variables WLangage n'est pas gérée dans cette version.
PHP Seule la liaison avec les rubriques d'un fichier de données est gérée. La liaison avec les variables WLangage n'est pas gérée dans cette version.
Versions 22 et supérieures
AndroidWidget Android A partir de la version 22, la liaison avec les variables du WLangage est gérée.
Nouveauté 22
AndroidWidget Android A partir de la version 22, la liaison avec les variables du WLangage est gérée.
AndroidWidget Android A partir de la version 22, la liaison avec les variables du WLangage est gérée.
Versions 15 et supérieures
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarques :
  • La fonction EcranVersFichier ne permet pas d'écrire dans le fichier de données : seules les variables des rubriques du fichier sont affectées (c'est-à-dire les variables de l'enregistrement chargé en mémoire). Pour modifier les enregistrements, il faut utiliser les fonctions HAjoute, HModifie, HEcrit, ...
  • En WEBDEV, il est également possible d'utiliser la fonction PageVersFichier.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Exemple
// Clic sur le bouton "Ajouter"
EcranVersFichier()
HAjoute(Client)
SI HErreurDoublon() = Vrai ALORS
Erreur("Ce numéro existe déjà")
FIN
Syntaxe
EcranVersFichier([<Nom de la fenêtre> [, <Nom de la source>]])
<Nom de la fenêtre> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom de la fenêtre/page où les champs sont présents. Si ce paramètre n'est pas spécifié ou correspond à une chaîne vide (""), la fenêtre/page à laquelle appartient le code en cours est utilisée.
PHP Si ce paramètre est spécifié, il doit correspondre au nom de la page en cours. Dans le cas contraire, une erreur est affichée.
AndroidWidget AndroidJava Si ce paramètre est spécifié, il doit correspondre au nom de la fenêtre en cours. Dans le cas contraire, une erreur est affichée.
<Nom de la source> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom de la source à laquelle appartiennent les données à mettre à jour. Cette source peut être :
  • Le nom d'un fichier de données : seuls les champs ayant un lien avec ce fichier de données sont pris en compte.
  • Le nom d'une variable WLangage : seuls les champs ayant un lien avec cette variable WLangage sont pris en compte.
    Remarques :
    • Si le nom de la variable est indiqué entre guillemets, la liaison sera effectuée avec la variable spécifiée.
    • Si le nom de la variable n'est pas indiqué entre guillemets, la liaison sera effectuée avec le contenu de la variable (cas par exemple d'une variable contenant le nom d'une autre variable).
Si ce nom n'est pas spécifié, tous les champs de la fenêtre/page ayant un lien avec un fichier de données décrit sous l'éditeur d'analyses ou une variable WLangage sont pris en compte.
Remarques

Lien d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données

La liaison d'un champ avec une variable WLangage ou avec une rubrique d'un fichier de données peut être connue :
  • Sous l'éditeur, dans la fenêtre de description du champ (onglet "Liaison").
  • Par programmation, grâce à la propriété ..Liaisonfichier.

Mise à jour des rubriques : Cas particuliers

  • Pour affecter automatiquement la valeur NULL à une rubrique avec la fonction EcranVersFichier :
    1. Cochez l'option "NULL supporté" pour la rubrique dans l'éditeur d'analyses.
    2. Cochez l'option "NULL si vide" dans le champ de saisie associé à la rubrique.
  • Les rubriques du fichier de données non reliées à un champ ne sont pas mises à jour par la fonction EcranVersFichier.
  • Si plusieurs champs de la fenêtre/page sont reliés à une même rubrique du fichier de données, la rubrique reliée peut ne pas être mise à jour correctement par la fonction EcranVersFichier. Il est déconseillé de relier plusieurs champs d'une fenêtre/page à une même rubrique d'un fichier de données.
  • La fonction EcranVersFichier n'affecte pas les rubriques pour les champs de type image. Utilisez la fonction HAttacheMémo.
  • La fonction EcranVersFichier ne fonctionne pas avec les vues.
Composantes
WINDEVEtats et Requêtes wd220obj.dll
WEBDEV - Code Serveur wd220page.dll
Windows Mobile wp220obj.dll
Java wd220java.jar
Linux wd220obj.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Ne s'applique pas au "Modèle de champs"
Cette fonction prend en paramètre une fenêtre ou une page mais aucune erreur n'est engendrée si on met à la place un modèle de champs mais la foction ne marche que s'il n'y a qu'une seule instance du modèle.
Amine MERIMI ( Analy
04 juil. 2013