Field

Verwenden Sie das Field-Objekt gemeinsam mit FieldList, um die auf dem Bildschirm in einem Feld enthaltenen Informationen abzurufen.

Tabelle 5-20 Feld

Methode

 

getAttributes()

Gibt die für diese Feldinstanz angegebene Attributgruppe zurück. Weitere Informationen hierzu finden Sie in AttributeSet.

Ausgabe

{AttributeSet} Die Attributgruppe für dieses Feld

getForegroundColor()

Gibt die Vordergrundfarbe des Felds zurück.

Ausgabe

{Number} Die Vordergrundfarbe für dieses Feld. Diese Werte werden im Color-Objekt definiert.

getBackgroundColor()

Gibt die Hintergrundfarbe des Felds zurück.

Ausgabe

{Number} Die Hintergrundfarbe für dieses Feld. Diese Werte werden im Color-Objekt definiert.

getStart()

Gibt die Anfangsposition des Felds zurück. Die Anfangsposition ist die Position des ersten Zeichens im Feld. Einige Hosttypen verwenden eine Zeichenposition zum Speichern von Feldebenenattributen. In diesem Fall wird die Attributposition nicht als Anfangsposition betrachtet.

Ausgabe

{Position} Anfangsposition des Felds.

Ergebnis

{RangeError} Für Felder ohne Länge.

getEnd()

Gibt die Endposition des Felds zurück. Die Endposition ist die Position im Darstellungsbereich mit dem letzten Zeichen des Felds.

Ausgabe

{Position} Endposition des Felds.

Ergebnis

{RangeError} Für Felder ohne Länge.

getLength()

Gibt die Länge des Felds zurück. Bei Hosttypen, die zum Speichern der Feldattribute eine Zeichenposition verwenden, ist die Feldattributposition nicht in der Feldlänge enthalten.

Ausgabe

{Number} Länge des Felds.

getDataCells()

Ruft die Datenzellen ab, die dieses Feld bilden. Weitere Informationen hierzu finden Sie in DataCell.

Ausgabe

{DataCell[]}Datenzellen, die dieses Feld bilden.

getText()

Ruft den Text aus dem Feld ab.

Ausgabe

{String} Feldtext.

setText()

Legt den Feldtext fest. Bei bestimmten Hosttypen wie VT wird der Text sofort an den Host übertragen. Bei anderen Hosttypen wiederum wird der Text erst dann an den Host übertragen, wenn die AID-Taste aufgerufen wird. Wenn der Text kürzer als das Feld ist, wird er im Hostfeld platziert, und der Rest des Felds wird gelöscht. Wenn der Text länger als das Hostfeld ist, wird so viel Text wie möglich im Feld platziert.

Parameter

{String}Text, der im Feld gesetzt wird.

Ergebnis

{Error} Wenn das Feld geschützt ist.

clearField()

Löscht das aktuelle Feld emulationsspezifisch.

Ergebnis

{Error} Wenn das Feld geschützt oder Löschen nicht unterstützt wird.

getPresentationSpace()

Ruft das PresentationSpace-Objekt ab, das dieses Feld erstellt hat.

Ausgabe

{PresentationSpace} Übergeordnetes Element dieser Feldinstanz.

toString()

Erstellt eine benutzerfreundliche Beschreibung des Felds.

Ausgabe

{String} Von Benutzern lesbare Darstellung des Felds.