Verwenden Sie das PresentationSpace-Objekt zur Interaktion mit dem Terminalbildschirm. Zu den verfügbaren Interaktionen zählen das Einrichten und Abrufen der Cursorposition, das Senden von Tasten und das Lesen von Text.
Tabelle 5-31 PresentationSpace
|
METHODEN |
|
|---|---|
|
getCursorPosition() |
Gibt eine Position-Instanz zurück, die die aktuelle Cursorposition darstellt. Eine Sitzung ohne Verbindung weist die Cursorposition 0,0 auf. Ausgabe {Position} aktuelle Cursorposition |
|
setCursorPosition(position) |
Bewegt den Hostcursor an die angegebene Zeilen- und Spaltenposition. Bei einigen Hosts wie VT werden die Cursorbewegungen durch den Host eingeschränkt. Parameter {Position} Position neue Cursorposition. Ausgabe Keine Ergebnis {RangeError} Wenn die Position auf dem aktuellen Bildschirm ungültig ist. |
|
isCursorVisible() |
Testet, ob der Cursor aktuell im Präsentationsbereich angezeigt wird. Wenn die Sitzung nicht verbunden ist, wird der Cursor als nicht sichtbar betrachtet. Ausgabe {Boolean} 'True', wenn der Cursor angezeigt wird. 'False', wenn der Cursor nicht angezeigt wird. |
|
sendKeys(keys) |
Überträgt eine Textzeichenfolge oder ControlKey an der aktuellen Cursorposition im Präsentationsbereich an den Host. Wenn sich der Cursor nicht an der gewünschten Position befindet, verwenden Sie zunächst die setCursorPosition-Funktion. Die Textzeichenfolge kann eine beliebige Anzahl an Zeichen und ControlKey-Objekten enthalten. Ein Beispiel: "myname" + ControlKey.TAB + "mypass" + ControlKey.ENTER überträgt eine Benutzerkennung, tabuliert zum nächsten Feld und überträgt zunächst ein Passwort und dann die Eingabetaste. Um eine eckige Klammer zu übertragen, geben Sie die Klammern doppelt ein ([[ oder ]]). Parameter {String} Tastentext und/oder Steuertasten, der/die übertragen werden soll(en). |
|
getText(start,length) |
Gibt eine Zeichenfolge zurück, die einen linearen Bereich des Präsentationsbereichs darstellt. Wenn Zeilengrenzen auftreten, werden keine Zeichen für neue Zeilen eingefügt. Parameter {Position} Startposition, aus der Text abgerufen wird. {Number} Länge der maximalen Anzahl an Zeichen, die zurückgegeben werden sollen. Wenn durch den Längenparameter die letzte Position des Präsentationsbereichs überschritten wird, werden nur die Zeichen bis zur letzten Position zurückgegeben. Ausgabe {String) stellt einen linearen Bereich des Präsentationsbereichs dar, der leer sein kann, wenn die Sitzung nicht verbunden ist. Ergebnis {RangeError} Wenn die Position oder Länge auf dem aktuellen Bildschirm ungültig ist. |
|
getSize() |
Ruft die Abmessungen des Bildschirms als Dimension-Objekt ab. Ausgabe {Dimension} Enthält die Anzahl an Zeilen und Spalten. Die Bildschirmgröße beträgt [row:0, col:0], wenn die Sitzung nicht verbunden ist. |
|
getDataCells(start, length) |
Gibt DataCell-Instanzen zurück, bei denen das erste Mitglied für die durch den Startparameter angegebene Position gedacht ist. Die maximale Anzahl an DataCell-Instanzen in der Liste wird durch den Längenparameter angegeben. Parameter {Position} Start der ersten Position auf dem Hostbildschirm, auf dem DataCell-Instanzen abgerufen werden sollen. Weitere Informationen hierzu finden Sie in Position. {Number} Länge der maximalen Anzahl an DataCell-Instanzen, die abgerufen werden sollen. Wenn die Länge nicht angegeben ist, werden DataCell-Instanzen von der Startposition bis zum Ende des Bildschirms zurückgegeben. Ausgabe {DataCell[]}-Instanzen, die leer sein können, wenn die Sitzung nicht verbunden ist. Wenn die Position nicht angegeben ist, werden alle DataCell-Instanzen zurückgegeben. Wenn die Länge nicht angegeben ist, werden DataCell-Instanzen von der Startposition bis zum Ende des Bildschirms zurückgegeben. Ergebnis {RangeError} Wenn Start oder Länge außerhalb des Wertebereichs liegt. |
|
getFields() |
Gibt eine Liste der Felder im Präsentationsbereich zurück. Wenn der Hosttyp keine Felder unterstützt oder der aktuelle Bildschirm nicht formatiert wurde, ist der Rückgabewert immer eine leere Liste. Weitere Informationen hierzu finden Sie in FieldList. Ausgabe {FieldList} von durch den Host definierten Feldern im Präsentationsbereich. |