FORM LIRE OBJETS

4D v16.3

FORM LIRE OBJETS


FORM LIRE OBJETS ( tabObjets {; tabVariables {; tabPages}} {; optionPage \| *} )

Paramètre	Type	Description
tabObjets	Tableau chaîne	Noms des objets du formulaire
tabVariables	Tableau pointeur	Pointeurs sur les variables ou champs associés aux objets
tabPages	Tableau entier	Numéro de page de chaque objet
optionPage \| *	Entier long, Opérateur	1=Page courante du formulaire, 2=Toutes les pages, 4=Pages héritées Si * passé (obsolète) = page courante avec objets hérités

Description

La commande FORM LIRE OBJETS retourne sous forme de tableau(x) la liste de tous les objets présents dans le formulaire courant. Cette liste peut être restreinte à la page courante du formulaire et peut exclure les objets des formulaires hérités. La commande peut être utilisée avec les formulaires entrée et sortie.

Si un tableau passé en paramètre n’est pas préalablement déclaré, la commande le crée et le dimensionne automatiquement. Toutefois, dans la perspective de la compilation de l’application, il est recommandé de déclarer explicitement chaque tableau.

Passez dans tabObjets le nom du tableau texte devant être rempli avec les noms des objets (chaque nom d’objet est unique au sein d’un formulaire). L’ordre dans lequel les objets apparaissent dans le tableau n’est pas significatif.

Les autres tableaux remplis facultativement par la commande sont synchronisés avec le premier.

Passez dans le paramètre facultatif tabVariables le nom du tableau de pointeurs devant être rempli avec des pointeurs vers les variables ou champs associés aux objets. Si un objet n’a pas de variable associée, le pointeur Nil est retourné. Dans le cas d’un objet de type “sous-formulaire”, un pointeur sur la table du sous-formulaire est retourné.

Le troisième tableau (facultatif), tabPages, est rempli avec les numéros de pages du formulaire. Chaque ligne de ce tableau contient le numéro de la page sur laquelle se trouve l’objet correspondant.

Le paramètre optionnel optionPage vous permet de désigner la ou les partie(s) du formulaire dont vous souhaitez lire les objets. Par défaut, si le paramètre optionPage est omis (ainsi que le paramètre *), les objets de toutes les pages, y compris les objets hérités, sont retournés. Pour délimiter la portée de la commande, vous pouvez passer une (ou une combinaison) des constantes suivantes du thème "Objets de formulaire (Accès)" dans le paramètre optionPage :

Constante	Type	Valeur	Comment
Form hérité	Entier long	4	Retourne uniquement les objets hérités
Form page courante	Entier long	1	Retourne tous les objets de la page courante, y compris ceux de la page 0, mais exclut les objets hérités
Form toutes les pages	Entier long	2	Retourne tous les objets de toutes les pages, mais exclut les objets hérités

Note de compatibilité : Passer le paramètre * équivaut à passer Form page courante+Form hérité. Cependant, la syntaxe utilisant le paramètre * est obsolète et ne doit plus être utilisée.

Exemple 1

Vous souhaitez obtenir les objets de toutes les pages, y compris ceux des formulaires hérités (le cas échéant):

  //Formulaire ouvert

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages)

Ou :

  //Formulaire chargé

 FORM CHARGER([Table1];"MonForm")

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages;Form toutes les pages+Form hérité)

Exemple 2

Vous souhaitez obtenir les objets de la page courante du formulaire chargé, incluant la page 0 de ce formulaire ainsi que les objets des formulaires hérités (le cas échéant) :

 FORM CHARGER("MonForm")

 FORM ALLER A PAGE(2)

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages;Form page courante+Form hérité)

Exemple 3

Vous souhaitez obtenir les objets des formulaires hérités. S'il n'y a pas de formulaire hérité, les tableaux seront retournés vides.

 FORM CHARGER("MonForm")

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages;Form hérité)

Exemple 4

Vous souhaitez obtenir les objets de la page 4, ainsi que ceux de la page 0, mais pas ceux des formulaires hérités (le cas échéant) :

 FORM CHARGER([Table1];"MyForm")

 FORM ALLER A PAGE(4)

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages;Form page courante)

Exemple 5

Vous souhaitez obtenir les objets de toutes les pages, mais sans ceux des formulaires hérités :

 FORM CHARGER([Table1];"MonForm")

 FORM LIRE OBJETS(tabObjets;tabVariables;tabPages;Form toutes les pages)

Voir aussi

FORM LIRE PROPRIETES
Objets (Formulaires)
Objets de formulaire (Accès)