Utilizzare l'oggetto PresentationSpace per interagire con lo schermo del terminale. Le interazioni disponibili includono l'impostazione e l'ottenimento della posizione del cursore, l'invio di chiavi e la lettura del testo.
Tabella 5-31 PresentationSpace
|
METODI |
|
|---|---|
|
getCursorPosition() |
Restituisce un'istanza di Position che rappresenta la posizione corrente del cursore. In una sessione non connessa la posizione del cursore è 0,0. Restituisce {Position} posizione corrente del cursore |
|
setCursorPosition(position) |
Sposta il cursore dell'host alla posizione specificata nella riga e nella colonna. Per alcuni host, ad esempio VT, l'host potrebbe limitare gli spostamenti del cursore. Parametri {Position} Position nuova posizione del cursore. Restituisce Nessun valore Genera {RangeError} se la posizione non è valida sullo schermo corrente. |
|
isCursorVisible() |
Verifica che il cursore sia attualmente visibile nello spazio di presentazione. Se la sessione non è connessa il cursore è considerato non visibile. Restituisce {Boolean} True se il cursore è visibile. False se il cursore non è visibile. |
|
sendKeys(keys) |
Trasmette una stringa di testo o ControlKey all'host nella posizione corrente del cursore nello spazio di presentazione. Se il cursore non è nella posizione desiderata, utilizzare prima la funzione setCursorPosition. La stringa di testo può contenere qualsiasi numero di caratteri e oggetti ControlKey. Ad esempio: "myname" + ControlKey.TAB + "mypass" + ControlKey.ENTER trasmetterà un ID utente, il tasto Tab per passare al campo successivo, una password, quindi il tasto Invio. Se è necessario trasmettere una parentesi quadra, raddoppiare le parentesi ([[ o ]]). Parametri {String} testo del tasto e/o tasti di controllo da trasmettere |
|
getText(start,length) |
Restituisce una stringa che rappresenta un'area lineare dello spazio di presentazione. Se vengono rilevati limiti di riga, non vengono inseriti caratteri di nuova riga. Parametri {Position} posizione iniziale dalla quale recuperare il testo {Number} lunghezza del numero massimo di caratteri da restituire. Se il parametro della lunghezza causa il superamento dell'ultima posizione dello spazio di presentazione, verranno restituiti solo i caratteri fino all'ultima posizione. Restituisce {String) che rappresenta un'area lineare dello spazio di presentazione che potrebbe essere vuoto se la sessione non è connessa. Genera {RangeError} se la posizione o la lunghezza non sono valide sullo schermo corrente. |
|
getSize() |
Ottiene le dimensioni dello schermo come un oggetto Dimension. Restituisce {Dimension} Contenente il numero di righe e colonne. Le dimensioni dello schermo sono [row:0, col:0] se la sessione non è connessa. |
|
getDataCells(start, length) |
Restituisce istanze di DataCell in cui il primo membro sarà la posizione specificata dal parametro start. Il numero massimo di istanze di DataCell nell'elenco è specificato dal parametro length. Parametri {Position} posizione iniziale sullo schermo dell'host in cui recuperare le istanze di DataCell. Vedere Position. {Number} lunghezza del numero massimo di istanze di DataCell da recuperare. Se non è specificato, restituisce DataCell dalla posizione iniziale fino alla fine dello schermo. Restituisce {DataCell[]} Istanze che possono essere vuote se la sessione non è connessa. Se la posizione non è specificata, restituisce tutti i DataCell. Se la lunghezza non è specificata, restituisce i DataCell dalla posizione iniziale alla fine dello schermo. Genera {RangeError} se l'inizio o la lunghezza sono al di fuori dell'intervallo. |
|
getFields() |
Restituisce un elenco di campi nello spazio di presentazione. Se il tipo di host non supporta i campi o lo schermo corrente non è formattato, il valore restituito sarà sempre un elenco vuoto. Vedere FieldList. Restituisce {FieldList} di campi definiti dall'host nello spazio di presentazione. |