EDIT FORM

4D v16.3

EDIT FORM


EDIT FORM ( laTable ; formulaire {; formUtilisateur {; bibliothèque}} )

Paramètre	Type	Description
laTable	Table	Table du formulaire à modifier
formulaire	Chaîne	Nom du formulaire table à modifier
formUtilisateur	Chaîne	Nom du formulaire utilisateur à modifier
bibliothèque	Chaîne	Chemin d'accès complet de la bibliothèque d’objets utilisable

Description

La commande EDIT FORM ouvre le formulaire table désigné par les paramètres laTable, formulaire ainsi que, facultativement, formUtilisateur dans l’éditeur de formulaires utilisateurs :

Note : La fenêtre de l’éditeur ne s’ouvre que si elle est la première fenêtre du process. Autrement dit, il sera généralement nécessaire d’ouvrir un nouveau process pour afficher l’éditeur.

Si vous passez une chaîne vide dans le paramètre formUtilisateur et s’il n’existe pas déjà un formulaire utilisateur lié à formulaire, le formulaire source est affiché dans l’éditeur. Le formulaire modifié est ensuite dupliqué dans le fichier de structure utilisateur (.4DA) et sera utilisé en remplacement de formulaire.

Si un formulaire utilisateur avait déjà été généré à partir de formulaire à l’aide de cette commande, le formulaire utilisateur s’affiche dans l’éditeur. Si vous souhaitez dans ce cas repartir du formulaire source, vous devez au préalable supprimer le formulaire utilisateur à l’aide de la commande DELETE USER FORM.

Le paramètre formUtilisateur permet de désigner un formulaire utilisateur (créé à l’aide de la commande CREATE USER FORM) à modifier. Dans ce cas, ce formulaire est affiché dans l’éditeur.

Passez dans le paramètre facultatif bibliothèque le chemin d’accès complet de la bibliothèque d’objets que l’utilisateur sera autorisé à utiliser pour personnaliser le formulaire. Lorsqu’elles sont utilisées dans le contexte de l’éditeur de formulaires utilisateurs, les bibliothèques d’objets permettent de coller des objets avec leurs propriétés graphiques et leurs actions automatiques. Les objets auxquels une méthode est associée n’apparaissent pas dans la bibliothèque. Attention, il est du ressort du développeur de vérifier que l’ajout des objets d’une bibliothèque n’est pas incompatible avec le formulaire utilisateur (et ses objets) au niveau des noms, des variables et des types.

En mode client/serveur, la bibliothèque doit se trouver dans le dossier Resources de la base de données, au même niveau que le dossier Plugins, afin qu’elle soit disponible sur tous les postes clients. Si la bibliothèque est valide, elle est ouverte avec la fenêtre du formulaire.

Pour plus d’informations sur les bibliothèques d’objets, reportez-vous au manuel Mode Développement de la documentation de 4D.

Exemple

Dans cet exemple, l'utilisateur peut choisir une bibliothèque puis modifier un formulaire de dialogue :

 MAP FILE TYPES("4DLB";"4IL";"Bibliothèque 4D")

 $vAbib:=Select document(1;"4DLB";"Veuillez sélectionner une bibliothèque";0)

 If(OK=1)

  `Une bibliothèque a été choisie

    $vACheminLib:=Document

 Else

    $vACheminLib:=""

 End if

 

 EDIT FORM([Dialogs];"Welcome";"";$vACheminLib)

 If(OK=1)

  `Présentation du formulaire modifié

    DIALOG([Dialogs];"Welcome")

 End if

Variables et ensembles système

Si l’utilisateur sauvegarde les modifications éventuellement effectuées dans l'éditeur, la variable OK prend la valeur 1. En cas d'erreur, OK prend la valeur 0.

Gestion des erreurs

Une erreur est générée si :

le formulaire n’a pas été déclaré modifiable par l’utilisateur en mode Développement ou n’existe pas,
le formulaire est déjà ouvert en modification dans un autre process,
l’utilisateur ne possède pas les droits d’accès adéquats.
Vous pouvez intercepter ces erreurs à l’aide d’une méthode installée par la commande ON ERR CALL.

Voir aussi

CREATE USER FORM
DELETE USER FORM
LIST USER FORMS
Présentation des formulaires utilisateurs