FORM GET OBJECTS

Home

4D v16.3

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	Lange Ganzzahl, Operator	1=Form current page, 2=Form all pages, 4=Form inherited Mit * (überholt) = Aktuelle Seite mit vererbten Objekten

Beschreibung

Der Befehl FORM GET OBJECTS gibt die Liste aller Objekte im aktuellen Formular als Array zurück. Diese Liste lässt sich auf die aktuelle Formularseite beschränken. Der Befehl lässt sich mit Eingabe- und Ausgabeformularen verwenden.

Wurde ein als Parameter übergebenes Array nicht zuvor deklariert, legt der Befehl dieses an und setzt seine Größe automatisch. Es empfiehlt sich jedoch, jedes Array explizit zu deklarieren, da Sie in der Regel Ihre Anwendung kompilieren.
In ArrayObjekte übergeben Sie den Namen des String Array mit den Objektnamen. Jeder Objektname innerhalb eines Formulars ist einmalig. Die Reihenfolge der Objekte ist ohne Bedeutung.
Die weiteren Arrays füllt der Befehl bei Bedarf, sie werden mit dem ersten Array synchronisiert.

Im optionalen Parameter ArrayVariablen übergeben Sie den Namen des Array mit Zeigern. Es enthält bereits die Zeiger auf die Variablen/Felder, die Objekten zugeordnet sind. Für Objekte ohne Variable wird der Zeiger Nil zurückgegeben. Für Objekte vom Typ Unterformular wird ein Zeiger auf die Tabelle des Unterformulars zurückgegeben.

Der optionale Parameter ArraySeiten enthält die jeweiligen Seitennummern zu den Objekten im Formular. Jede Zeile dieses Array enthält die Seitennummer des dazugehörigen Objekts.
Objekte aus einem vererbten Formular gehören zur Seite 0 der aktuellen Seite.

Mit dem optionalen Parameter * können Sie die Liste der zurückgegebenen Objekte auf die aktuelle Seite des Formulars beschränken. Dann gibt der Befehl nur die Objekte der aktuellen Seite, von Seite 0 und den vererbten Seiten zurück, d.h. der Befehl bearbeitet alle Objekte auf der aktuellen Seite, egal ob sichtbar oder nicht.

Mit dem optionalen Parameter FormSeiteOption können Sie bestimmte Teile des Formulars angeben, aus denen Sie Objekte erhalten wollen. Standardmäßig, also ohne den Parameter FormSeiteOption (und ohne den Parameter *), werden Objekte von allen Seiten zurückgegeben, inkl. vererbte Objekte. 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	Kommentar
Form all pages	Lange Ganzzahl	2	gibt alle Objekte von allen Seiten ohne vererbte Objekte zurück
Form current page	Lange Ganzzahl	1	Gibt alle Objekte der aktuellen Seite zurück, einschließlich der Seite 0, aber ohne vererbte Objekte
Form inherited	Lange Ganzzahl	4	Gibt nur die vererbten Objekte zurück

Hinweis zur Kompatibilität: 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)

Siehe auch

FORM GET PROPERTIES
Formularobjekte (Zugriff)
Objekte (Formulare)