FORM LIRE OBJETS

4D v15

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	Opérateur \| Entier long	->	Si * passé = réduire à la page courante, ou
			1=Page courante du formulaire, 2=Toutes les pages, 4=Pages héritées

Description

Introduit dans 4D v14 R2

La commande FORM LIRE OBJETS (thème "Formulaires") accepte un nouveau paramètre optionnel, optionPage, vous permettant 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 (comme dans les versions précédentes de 4D).

Pour délimiter la portée de la commande, vous pouvez utiliser le paramètre optionPage. Vous pouvez passer une (ou une combinaison) des constantes suivantes, placées dans le thème "Objets de formulaire (Accès)" :

Constante	Type	Value	Description
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
Form hérité	Entier long	4	retourne uniquement les objets hérités

Note : Passer le paramètre * équivaut à passer Form page courante+Form hérité. La syntaxe utilisant le paramètre * est désormais 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)