Présentation

Un sous-formulaire est un formulaire inclus dans un autre formulaire.

Il existe deux grandes familles de sous-formulaires :

• les Sous-formulaires en liste, généralement destinés à saisir, visualiser et modifier des données provenant d’autres tables,
• les Sous-formulaires en page, permettant d'utiliser des objets d'interface sophistiqués et dédiés, comme par exemple les widgets 4D.

Chaque famille de sous-formulaire dispose de mécanismes et de propriétés qui lui sont propres.

Afin de bien définir les notions mises en oeuvre avec les sous-formulaires, voici quelques définitions relatives aux termes employés :

• Sous-formulaire : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent.
• Formulaire parent : formulaire contenant un ou plusieurs sous-formulaire(s).
• Conteneur de sous-formulaire : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire.
• Instance de sous-formulaire : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent.
• Formulaire liste écran : instance de sous-formulaire en liste.
• Formulaire détaillé: formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste.

Vous pouvez ajouter une instance de sous-formulaire dans un formulaire de plusieurs manières :

• dans l’assistant de création de formulaires, en utilisant la page Sous-formulaire des options avancées (cf. section Créer un formulaire via l'assistant)
• dans l’éditeur de formulaires, en utilisant l’outil Sous-formulaire de la barre d’objets ,
• en effectuant un glisser-déposer depuis la Page Formulaires de l’Explorateur.

Note : Un objet de type sous-formulaire (en page) est également créé lorsque vous ajoutez un objet Widget via la bibliothèque d'objets (cf. Utiliser la bibliothèque préconfigurée).

Bien entendu, vous pouvez mixer ces différentes techniques en fonction de vos besoins.

Vous définissez le type du formulaire en cochant ou non l'option Sous-formulaire liste dans le thème “Sous-formulaire” de la Liste des propriétés. La sélection ou la désélection de cette option provoque la mise à jour de la Liste des propriétés et l'affichage des options relatives à la famille de sous-formulaires générée. 

Les widgets 4D sont des objets composés prédéfinis. Utilisables avec ou sans programmation, ces widgets donnent accès à des fonctionnalités standard et sont très simples à mettre en oeuvre. Les widgets disponibles dans 4D sont les suivants :

• SearchPicker : zone de recherche d’apparence standard.
• DatePicker : sélecteur de date.
• TimePicker : sélecteur d’heure.

Les widgets 4D sont des sous-formulaires en page dotés de fonctions spécifiques. Vous pouvez les ajouter dans vos formulaires via l'outil de création de sous-formulaire (cf. paragraphe précédent), soit via la bibliothèque d’objets intégrée de 4D (cf. section Utiliser la bibliothèque préconfigurée).

L'utilisation des widgets est décrite dans un manuel séparé, 4D Widgets.