Propriétés des formulaires
Schéma de couleurs
La propriété de schéma de couleurs n'est appliquée que sur macOS.
Cette propriété définit la palette de couleurs du formulaire. Par défaut, lorsque la propriété n'est pas définie, la valeur d'une palette de couleurs est héritée (le formulaire utilise la palette définie au niveau de l'application). Pour le formulaire, cette option peut être remplacée par l'une des deux options suivantes :
- dark - texte clair sur fond foncé
- light - texte foncé sur fond clair
Une palette de couleurs définie ne peut pas être remplacée par un CSS.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| colorScheme | string | "dark", "light" |
CSS
Cette propriété vous permet de charger le(s) fichier(s) CSS spécifiques pour le formulaire.
Un fichier CSS défini au niveau du formulaire remplacera la ou les feuilles de style par défaut. Pour plus d'informations, veuillez vous référer à la page Feuilles de style.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| css | string ou collection | Chemin du fichier CSS fourni sous forme de : |
Pages
Chaque formulaire est composé d'au moins deux pages :
- une page 0 (page de fond)
- une page 1 (page principale)
Pour plus d'informations, veuillez consulter le thème Pages formulaire.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| pages | collection | Collection de pages (chaque page est un objet, la page 0 est le premier élément) |
Nom du formulaire
Cette propriété est le nom du formulaire lui-même et est utilisée pour faire référence au formulaire par son nom dans le langage 4D. Le nom du formulaire doit respecter les règles spécifiées pour les identifiants dans 4D.
Grammaire JSON
Le nom du formulaire est défini par le nom du dossier qui contient le fichier form.4Dform. Voir la page Architecture d'un projet pour plus d'informations.
Type de formulaire
Le type de formulaire, i.e. sa destination, définit les fonctionnalités qui seront disponibles pour le formulaire. Par exemple, les marqueurs ne peuvent être définis que pour les formulaires table en liste (sortie).
Chaque table dans une base de données a généralement au moins deux formulaires table. Un pour lister les enregistrements à l'écran et l'autre pour afficher un enregistrement à la fois (utilisé pour la saisie et les modifications) :
-
Formulaire de sortie - le formulaire de sortie ou formulaire liste affiche une liste d'enregistrements, avec une seule ligne par enregistrement. Les résultats des recherches sont affichés dans un formulaire de sortie et les utilisateurs peuvent double-cliquer sur une ligne pour afficher le formulaire d'entrée pour cet enregistrement.
-
Formulaire d'entrée ou formulaire détail - utilisé pour la saisie des données. Il affiche un seul enregistrement par écran et comporte généralement des boutons permettant de sauvegarder et d'annuler les modifications apportées à l'enregistrement et de naviguer d'un enregistrement à l'autre (i.e., Premier enregistrement, Dernier enregistrement, Enregistrement précédent, Enregistrement suivant).
Les types pris en charge dépendent de la catégorie de formulaire :
| Type de formulaire | Grammaire JSON | Description | Prise en charge avec |
|---|---|---|---|
| Formulaire de détail | detailScreen | Un formulaire d'affichage pour la saisie et la modification des données | Formulaires projet - Formulaires table |
| Formulaire de détail pour l'impression | detailPrinter | Un rapport imprimé avec une page par enregistrement, comme une facture | Formulaires projet - Formulaires table |
| Formulaire de liste | listScreen | Un formulaire pour lister les enregistrements à l'écran | Formulaires table |
| Formulaire de liste pour l'impression | listPrinter | Un rapport imprimé qui liste les enregistrements | Formulaires table |
| Aucun | pas de destination | Un formulaire sans fonction spécifique | Formulaires projet - Formulaires table |
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| destination | string | "detailScreen", "listScreen", "detailPrinter", "listPrinter" |
Nom du formulaire hérité
Cette propriété désigne le formulaire duquel hériter dans le formulaire actuel.
Pour hériter d'un formulaire table, définissez la table dans la propriété Table de formulaire hérité.
Pour supprimer l'héritage, sélectionnez \<None> dans la liste des propriétés (ou " " en JSON).
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| inheritedForm | string | Nom du formulaire table ou projet OU chemin POSIX d'un fichier .json décrivant le formulaire OU objet décrivant le formulaire |
Table du formulaire hérité
Cette propriété spécifie la table de la base de données dont un formulaire est hérité dans le formulaire actuel.
Passez \<Aucun> dans la liste des propriétés (ou " " en JSON) pour hériter d'un formulaire projet.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| inheritedFormTable | string ou number | nom ou numéro de table |
Publié en tant que sous-formulaire
Pour qu'un formulaire de composant soit sélectionné comme sous-formulaire dans une base de données hôte, il doit avoir été explicitement partagé. Lorsque cette propriété est sélectionnée, le formulaire sera publié dans le projet hôte.
Seuls les projets formulaire peuvent être indiqués comme étant des sous-formulaires publiés.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| shared | boolean | true, false |
Mémoriser géométrie
Lorsque cette option est cochée, si la fenêtre est ouverte via la commande Creer fenetre formulaire avec le paramètre *, plusieurs paramètres du formulaire seront automatiquement mémorisés par 4D au moment de la fermeture de la fenêtre, quelle que soit la manière dont ils ont été modifiés au cours de la session :
- la page courante,
- la position, la taille et la visibilité de chaque objet du formulaire (y compris la taille et la visibilité des colonnes de list box).
Cette option ne prend pas en compte les objets générés via la commande
OBJECT DUPLICATE. Pour que l’utilisateur retrouve son environnement lors de l’utilisation de cette commande, le développeur doit répéter la séquence de création, définition et positionnement des objets.
Lorsque cette option est cochée, l’option Mémoriser valeur est en outre disponible pour certains objets.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| memorizeGeometry | boolean | true, false |
Voir également
Nom de la fenêtre
Le nom de la fenêtre est utilisé lorsque le formulaire est ouvert à l'aide des commandes Open form window et Open window dans l'environnement d'application. Le nom de la fenêtre apparaît dans la barre de titre de la fenêtre.
Vous pouvez utiliser des références dynamiques pour définir les noms de fenêtre des formulaires, c'est-à-dire :
- Une référence XLIFF standard stockée dans le dossier Resources.
- Un libellé de table ou de champ : La syntaxe à appliquer est la suivante :
<?[TableNum]FieldNum>ou<?[TableName]FieldName>. - Une variable ou un champ : La syntaxe à appliquer est la suivante :
\N-<VariableName> ;ou< ;[TableName]FieldName> ;. La valeur du champ ou de la variable sera affichée dans le nom de la fenêtre.
Le nombre de caractères pour un nom de fenêtre est limité à 31.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| windowTitle | string | Le nom de la fenêtre sous forme de texte brut ou de référence |