FORM GET ENTRY ORDER

Home

4D v18


FORM GET ENTRY ORDER ( ObjektNamen {; SeitenNr \| *} )

Parameter	Typ	Beschreibung
ObjektNamen	Array Text	ObjektNamen sortiert nach Eingabereihenfolge
SeitenNr \| *	Lange Ganzzahl, Operator	Nummer der Seite zum Erhalten der definierten Eingabereihenfolge (ohne Angabe aktuelle Seite) oder * zum Erhalten der aktuellen Eingabereihenfolge der aktuellen Seite

Beschreibung

Der Befehl FORM GET ENTRY ORDER gibt in ObjektNamen die sortierten Namen der Objekte zurück, die die Eingabereihenfolge im Formular definieren.

Ohne den Parameter * gibt FORM GET ENTRY ORDER die Eingabereihenfolge zurück, wie sie zuvor mit dem Befehl FORM SET ENTRY ORDER definiert wurde. Den Parameter SeitenNr können Sie weglassen oder übergeben:
- Ohne den Parameter SeitenNr gibt das Array ObjektNamen die Eingabereihenfolge für die aktuelle Seite zurück
- Mit dem Parameter SeitenNr gibt das Array ObjektNamen die Eingabereihenfolge für die Seite SeitenNr zurück
In beiden Fällen wird das Array ObjektNamen leer zurückgegeben, wenn nicht zuvor für das aktuelle Formular der Befehl FORM SET ENTRY ORDER aufgerufen wurde.

Mit dem Parameter * gibt FORM GET ENTRY ORDER die aktuelle Eingabereihenfolge der aktuellen Seite zurück, z.B. enthält das Array ObjektNamen nur gültige Objektnamen. Weitere Informationen dazu finden Sie unter dem Befehl FORM SET ENTRY ORDER. Die aktuelle Eingabefolge des Formulars kann folgendes sein:
- Die standardmäßige Eingabereihenfolge gemäß der Anordnung der Objekte
- Oder die Eingabefolge des Formulareditors (siehe Eingabereihenfolge der Daten ändern), falls verwendet
- Oder die Eingabereihenfolge, gesetzt durch Aufrufen von FORM SET ENTRY ORDER in aktuellen Prozess, falls verwendet
Die aktuelle Eingabereihenfolge enthält immer Objekte von der Seite 0 und von vererbten Formularen.

Hinweis: Bei Anwendung auf ein Hauptformular gibt dieser Befehl nicht die Eingabereihenfolge in einem Unterformular zurück.

Beispiel

Einige Objekte aus der aktuellen Eingabefolge ausschließen:

 ARRAY TEXT($arrTabOrderObject;0)

 C_LONGINT($vElem)

 

 FORM GET ENTRY ORDER($arrTabOrderObject;*) //die aktuelle Eingabefolge erhalten

 Repeat

    $vElem:=Find in array($arrTabOrderObject;"vTax@")

    If($vElem>0) //Objekte aus der Eingabefolge ausschließen, deren Name mit "vTax" beginnt

       DELETE FROM ARRAY($arrTabOrderObject;$vElem)

    End if

 Until($vElem<0)

 FORM SET ENTRY ORDER($arrTabOrderObject) //die neue Eingabefolge anwenden

Siehe auch

Eingabereihenfolge der Daten ändern
FORM SET ENTRY ORDER