4D Doc Center : FORM GET OBJECTS

4D v13.4

FORM GET OBJECTS


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

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
*	Operator	Mit * = Auf aktuelle Seite beschränken

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. Der Befehl bearbeitet alle Objekte auf der aktuellen Seite, egal ob sichtbar oder nicht.