OBJET LIRE SOUS FORMULAIRE

4D v20 R7


OBJET LIRE SOUS FORMULAIRE ( {* ;} objet ; ptrTable ; sousFormDetail {; sousFormListe} )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d'objet (si * est spécifié) ou Variable (si * est omis)
ptrTable	Table	Pointeur vers la table du formulaire
sousFormDetail	Texte	Nom du formulaire détail du sous-formulaire
sousFormListe	Texte	Nom du formulaire liste du sous-formulaire (formulaire table)

Description

La commande OBJET LIRE SOUS FORMULAIRE vous permet d’obtenir les noms du ou des formulaire(s) associé(s) à l’objet sous-formulaire désigné par les paramètres objet et *.

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable.

La commande retourne dans le paramètre ptrTable un pointeur vers la table du ou des formulaire(s) utilisé(s). Si le sous-formulaire utilise un formulaire projet, le paramètre contient Pointeur nil.

Dans les paramètres sousFormDetail et (optionnellement) sousFormListe, la commande retourne :

le nom du formulaire détaillé si le sous-formulaire a été créé dans l'éditeur de formulaires de 4D,
la valeur de l'attribut "name" du sous-formulaire s'il a été créé à partir d'un fichier .json ou d'un objet 4D.
Dans les deux cas, si l'attribut "name" est indéfini, la commande retourne :
- pour un fichier .json, le nom du fichier .json (sans extension)
- pour un objet, "untitled"

S’il n’y a pas de formulaire liste, une chaîne vide est retournée dans le paramètre sousFormListe.

Voir aussi

OBJET FIXER SOUS FORMULAIRE
OBJET LIRE TAILLE SOUS FORMULAIRE