FORM GET OBJECTS

Home

4D v15

FORM GET OBJECTS

FORM GET OBJECTS ( ArrayObjekte {; ArrayVariablen {; ArraySeiten}} {; * | FormSeiteOption} )

Parameter	Typ		Beschreibung
ArrayObjekte	Array String	<-	Name der Formularobjekte
ArrayVariablen	Array Zeiger	<-	Zeiger auf Variablen oder Felder, die Objekten zugeordnet sind
ArraySeiten	Array Ganzzahl	<-	Seitennummer für jedes Objekt
* \| FormSeiteOption	Operator \| Lange Ganzzahl	->	Mit = Auf aktuelle Seite beschränken oder*
			1=Form current page, 2=Form all pages, 4=Form inherited

Beschreibung

Eingeführt mit 4D v14 R2

Der Befehl FORM GET OBJECTS (Kapitel Formulare) hat jetzt den neuen Parameter FormSeiteOption. Damit können Sie den bzw. die Teile im Formular angeben, aus denen Sie Objekte erhalten wollen.

Standardmäßig, d.h. ohne den Parameter FormSeiteOption sowie ohne den Parameter *, werden Objekte von allen Seiten, einschließlich vererbter Objekte, zurückgegeben (wie in bisherigen 4D Versionen).

Um die Reichweite des Befehls zu reduzieren, übergeben Sie einen Wert in FormSeiteOption. Sie können eine oder mehrere kombinierte Konstanten aus dem Thema Formularobjekte (Zugriff) übergeben:

Konstante	Typ	Wert	Beschreibung
Form current page	Lange Ganzzahl	1	gibt alle Objekte der aktuellen Seite zurück, einschließlich der Seite 0, aber ohne vererbte Objekte
Form all pages	Lange Ganzzahl	2	gibt alle Objekte von allen Seiten ohne vererbte Objekte zurück
Form inherited	Lange Ganzzahl	4	gibt nur die vererbten Objekte zurück

Hinweis: Die Übergabe des Parameters * ist dasselbe wie Übergeben der Konstanten Form current page+Form inherited. Die Syntax mit dem Parameter * ist jetzt überholt und sollte nicht mehr verwendet werden.

Beispiel 1

Information auf allen Seiten erhalten, einschließlich Objekten von vererbten Formularen (sofern vorhanden):

  //offenes Formular

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray)

Oder:

  //geladenes Formular

 FORM LOAD([Table1];"MyForm")

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form all pages+Form inherited)

Beispiel 2

Nur Information auf der aktuellen Seite erhalten, mit Seite 0 des geladenen Formulars und vererbten Formularobjekten (sofern vorhanden):

 FORM LOAD("MyForm")

 FORM GOTO PAGE(2)

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form current page+Form inherited)

Beispiel 3

Information von allen Objekten im vererbten Formular (sofern vorhanden) erhalten. Gibt es kein vererbtes Formular, werden die Arrays leer zurückgegeben.

 FORM LOAD("MyForm")

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form inherited)

Beispiel 4

Information von Objekten auf Seite 4 erhalten, einschließlich Objekten von Seite 0, aber ohne vererbte Formularobjekte (sofern vorhanden):

 FORM LOAD([Table1];"MyForm")

 FORM GOTO PAGE(4)

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form current page)

Beispiel 5

Information von Objekten auf allen Seiten erhalten, jedoch ohne vererbte Formularobjekte (sofern vorhanden):

 FORM LOAD([Table1];"MyForm")

 FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form all pages)