4D Doc Center : FORM FIXER ENTREE

4D v14.3

FORM FIXER ENTREE


FORM FIXER ENTREE ( {laTable ;} formulaire {; formUtilisateur}{; *} )

laTable	Table	Table pour laquelle définir le formulaire entrée ou Table par défaut si ce paramètre est omis
formulaire	Chaîne	Nom du formulaire à utiliser
formUtilisateur	Chaîne	Nom du formulaire utilisateur à utiliser
*		Taille de fenêtre automatique

Description

FORM FIXER ENTREE désigne formulaire ou formUtilisateur comme formulaire entrée courant de laTable pour le process courant. formulaire doit appartenir à laTable.

La portée de cette commande est le process courant. Chaque table dispose d'un formulaire entrée courant pour chaque process.

Note : Pour des raisons structurelles, cette commande n'est pas compatible avec les formulaires projets. Si vous passez un formulaire projet dans formulaire, la commande ne fait rien.

La commande FORM FIXER ENTREE n'affiche pas de formulaire ; elle désigne juste celui qui sera affiché ou utilisé par d'autres commandes. Pour plus d'informations sur la création de formulaires, reportez-vous au manuel Mode Développement de 4D.

Pour chaque table de la base, un formulaire entrée par défaut est défini dans la fenêtre de l'Explorateur. Ce formulaire est utilisé si la commande FORM FIXER ENTREE n'est pas appelée, ou si le paramètre formulaire est invalide.

Le paramètre facultatif formUtilisateur permet de désigner un formulaire utilisateur (issu du formulaire) comme formulaire entrée par défaut. Si vous passez un nom de formulaire utilisateur valide, ce formulaire sera utilisé par défaut en lieu et place du formulaire entrée dans le process courant. Ce principe permet de disposer simultanément de différents formulaires utilisateurs personnalisés (générés à l’aide de la commande CREER FORMULAIRE UTILISATEUR) et d’utiliser celui qui convient en fonction du contexte.
Pour plus d’informations sur les formulaires utilisateurs, reportez-vous à la section Présentation des formulaires utilisateurs.

Le formulaire entrée est affiché par de nombreuses commandes. Ces commandes sont généralement utilisées pour la saisie ou la modification de valeurs. Les commandes suivantes affichent un formulaire entrée :

Les commandes VISUALISER SELECTION et MODIFIER SELECTION affichent une liste d'enregistrements dans le formulaire sortie. Chacune d'entre elles permet ensuite à l'utilisateur de double-cliquer sur un enregistrement, qui s'affiche alors dans le formulaire entrée.

Le formulaire entrée est aussi utilisé par les commandes d'import LECTURE DIF, LECTURE SYLK et IMPORTER TEXTE.

Le paramètre optionnel * est destiné à être utilisé conjointement avec les propriétés du formulaire, que vous définissez en mode Développement dans la fenêtre des Propriétés du formulaire, et avec la commande Creer fenetre. En passant le paramètre *, vous indiquez à 4D d'utiliser les propriétés du formulaire pour redimensionner automatiquement la fenêtre lors de l'utilisation ultérieure de la fenêtre comme formulaire entrée ou comme dialogue. Reportez-vous à la description de la commande Creer fenetre pour plus d'informations sur ce point.

Note : Que vous passiez ou non le paramètre *, FORM FIXER ENTREE change le formulaire entrée pour la table.

Exemple 1

L'exemple suivant illustre une utilisation typique de FORM FIXER ENTREE. A noter que, si dans cet exemple FORM FIXER ENTREE est appelé juste avant que le formulaire soit utilisé, cela n'est absolument pas nécessaire. FORM FIXER ENTREE peut en fait être exécuté dans une tout autre méthode, du moment qu'elle est exécutée avant celle-ci :

 FORM FIXER ENTREE([Sociétés];"Nouvelle Sté") ` Formulaire pour les nouvelles sociétés

 AJOUTER ENREGISTREMENT([Sociétés]) ` Ajout d'une nouvelle société

Exemple 2

Dans une base de facturation gérant plusieurs sociétés, la création d’une facture doit s’effectuer dans le formulaire utilisateur correspondant :

 Au cas ou

    :(société="4D SAS")

       FORM FIXER ENTREE([Factures];"Saisie";"4D_SAS")

    :(société="4D Inc")

       FORM FIXER ENTREE([Factures];"Saisie";"4D_Inc")

    :(société="Acme")

       FORM FIXER ENTREE([Factures];"Saisie";"ACME")

 Fin de cas

 AJOUTER ENREGISTREMENT([Factures])