FieldList

Verwenden Sie das FieldList-Objekt gemeinsam mit dem Field-Objekt zum Abrufen von Feldlisteninformationen.

Tabelle 5-21 FieldList

Methode

 

getPresentationSpace()

Ruft das PresentationSpace-Objekt ab, das diese Feldliste erstellt hat.

Ausgabe

{PresentationSpace} Übergeordnetes Element dieser Feldliste.

findField(position, text, direction)

Gibt das Feld mit dem angegebenen Text zurück. Der Suchvorgang beginnt an der angegebenen Position und verläuft vorwärts oder rückwärts. Wenn sich die Zeichenfolge über mehrere Felder erstreckt, wird das Feld zurückgegeben, das die Startposition enthält. Wenn vorwärts gesucht wird, findet kein Umbruch bis zum oberen Ende des Bildschirms statt. Wenn rückwärts gesucht wird, findet kein Umbruch bis zum unteren Ende des Bildschirms statt.

Parameter

{Position} Position, an der die Suche beginnen soll. Weitere Informationen finden Sie unter Position-Objekt.

{String} Der Text, nach dem gesucht werden soll (optional). Wenn nicht vorhanden, wird das nächste Feld rechts von oder unterhalb der angegebenen Position zurückgegeben.

{Number} Richtung der Suche (optional). Verwenden Sie für diesen Parameter PresentationSpace .SearchDirection-Konstanten. Zum Beispiel PresentationSpace.SearchDirection.FORWARD oder PresentationSpace.SearchDirection.BACKWARD. Wenn nicht vorhanden, wird vorwärts gesucht.

Ausgabe

{Field} enthält die Zeichenfolge oder Null, wenn ein Feld, das die vorgegebenen Kriterien erfüllt, nicht gefunden wird.

Ergebnis

{RangeError} Wenn die Position außerhalb des Wertebereichs liegt.

get(index)

Ruft das Feld am vorgegebenen Index ab.

Parameter

{Number}Index in die Feldliste.

Ausgabe

{Field} befindet sich am angegebenen Index.

Ergebnis

{RangeError} Wenn der Index außerhalb des Wertebereichs liegt.

isEmpty()

Gibt an, ob die Feldliste leer ist.

Ausgabe

{Boolean} 'True', wenn die Liste leer ist.

size()

Gibt die Anzahl der in der Liste enthaltenen Felder an.

Ausgabe

{Number} Die Feldanzahl

toString()

Erstellt eine benutzerfreundliche Beschreibung der Feldliste.

Ausgabe

{String} Von Benutzern lesbare Darstellung der Feldliste.