Skip to main content
Version: v20

Sous-formulaire


Autoriser la suppression

Indique si l’utilisateur peut supprimer des sous-enregistrements dans un sous-formulaire liste.

Grammaire JSON

NomType de donnéesValeurs possibles
deletableInListbooleantrue, false (par défaut : true)

Objets pris en charge

Sous-formulaire


Formulaire détaillé

Cette option permet de désigner un formulaire détaillé à utiliser dans un sous-formulaire. Il peut être :

  • un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. Dans ce cas, le sous-formulaire de liste et les propriétés Source doivent être vides ou non présents.
    Vous pouvez sélectionner un nom de formulaire de composant lorsqu'il est publié dans le composant.

    Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic).

  • le formulaire détaillé à associer au sous-formulaire de liste. Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table.

Grammaire JSON

NomType de donnéesValeurs possibles
detailFormstringName (string) of table or project form, a POSIX path (string) to a .json file describing the form, or an object describing the form

Objets pris en charge

Sous-formulaire


Double-clic sur ligne vide

Action to perform in case of a double-click on an empty line of a list subform. Les options suivantes sont disponibles :

  • Ne rien faire : ignore le double-clic.
  • Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. The record will be created directly in the list if the Enterable in List property is enabled. Sinon, il sera créé en mode page, dans le formulaire détaillé associé au sous-formulaire.

Grammaire JSON

NomType de donnéesValeurs possibles
doubleClickInEmptyAreaActionstring"addSubrecord" ou "" to do nothing

Objets pris en charge

Sous-formulaire

Voir également

Double-clic sur ligne


Double-clic sur ligne

Sous-formulaires liste

Définit l'action à réaliser lorsqu'un utilisateur double-clique sur une ligne dans un sous-formulaire liste. The available options are:

  • Do nothing (default): Double-clicking a row does not trigger any automatic action.
  • Modifier enregistrement : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le formulaire détaillé défini pour le sous-formulaire liste. The record is opened in read-write mode so it can be modified.
  • Display Record: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified.

Regardless of the action selected/chosen, the On Double clicked form event is generated.

For the last two actions, the On Open Detail form event is also generated. The On Close Detail is then generated when a record displayed in the detail form associated with the list box is about to be closed (regardless of whether or not the record was modified).

Grammaire JSON

NomType de donnéesValeurs possibles
doubleClickInRowActionstring"editSubrecord", "displaySubrecord"

Objets pris en charge

Sous-formulaire

Voir également

Double-clic sur ligne vide


Saisissable en liste

Lorsque cette propriété est activée pour un sous-formulaire de liste, l'utilisateur peut modifier les données de l'enregistrement directement dans la liste, sans avoir à utiliser le formulaire détaillé associé.

Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic).

Grammaire JSON

NomType de donnéesValeurs possibles
enterableInListbooleantrue, false

Objets pris en charge

Sous-formulaire


List Form

Cette option permet de désigner un formulaire liste à utiliser dans un sous-formulaire. Un sous-formulaire en liste vous permet de saisir, visualiser et modifier des données dans d’autres tables.

Les sous-formulaires de liste peuvent être utilisés pour la saisie de données de deux manières : l'utilisateur peut saisir des données directement dans le sous-formulaire ou les saisir dans un formulaire de saisie. Dans cette configuration, le formulaire utilisé comme sous-formulaire est appelé formulaire Liste. Le formulaire de saisie est appelé le formulaire détaillé.

Grammaire JSON

NomType de donnéesValeurs possibles
listFormstringName (string) of table or project form, a POSIX path (string) to a .json file describing the form, or an object describing the form

Objets pris en charge

Sous-formulaire


Source

Spécifie la table à laquelle appartient le sous-formulaire Liste (le cas échéant).

Grammaire JSON

NomType de donnéesValeurs possibles
tablestringNom de la table 4D, ou "" s'il n'existe aucune table.

Objets pris en charge

Sous-formulaire


Mode de sélection

Designates the option for allowing users to select rows:

  • None: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option Saisissable en liste soit activée. The navigation keys only cause the list to scroll; the On Selection Change form event is not generated.
  • Single: One row at a time can be selected in this mode. Clicking on a row will select it. A Ctrl+click (Windows) or Command+click (macOS) on a row toggles its state (between selected or not).
    The Up and Down arrow keys select the previous/next row in the list. Les autres touches de navigation font défiler la liste. The On Selection Change form event is generated every time the current row is changed.
  • Multiple: Several rows can be selected simultaneously in this mode.
    • Les sous-enregistrements sélectionnés sont retournés par la commande GET HIGHLIGHTED RECORDS.
    • Cliquer sur l'enregistrement permettra de le sélectionner, mais ne modifiera pas l'enregistrement courant.
    • Si vous pressez Ctrl+clic (Windows) ou Commande+clic (macOS) sur un enregistrement, cela fera basculer son état (entre sélectionné ou non). Les touches fléchées Haut et Bas sélectionnent l'enregistrement précédent/suivant dans la liste. Les autres touches de navigation font défiler la liste. L'événement formulaire On Selection Change est généré chaque fois que l'enregistrement sélectionné est modifié.

Grammaire JSON

NomType de donnéesValeurs possibles
selectionModestring"multiple", "single", "none"

Objets pris en charge

Sous-formulaire