FORM GET OBJECTS

4D v15

FORM GET OBJECTS

FORM GET OBJECTS ( 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 GET OBJECTS (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 GET OBJECTS(tabObjets;tabVariables;tabPages)

Ou :

  //Formulaire chargé

 FORM LOAD([Table1];"MonForm")

 FORM GET OBJECTS(tabObjets;tabVariables;tabPages;Form all pages+Form inherited)

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 LOAD("MonForm")

 FORM GOTO PAGE(2)

 FORM GET OBJECTS(tabObjets;tabVariables;tabPages;Form current page+Form inherited)

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 LOAD("MonForm")

 FORM GET OBJECTS(tabObjets;tabVariables;tabPages;Form inherited)

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 LOAD([Table1];"MyForm")

 FORM GOTO PAGE(4)

 FORM GET OBJECTS(tabObjets;tabVariables;tabPages;Form current page)

Exemple 5

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

 FORM LOAD([Table1];"MonForm")

 FORM GET OBJECTS(tabObjets;tabVariables;tabPages;Form all pages)