PresentationSpace

Utilice el objeto PresentationSpace para interactuar con la pantalla del terminal. Entre las interacciones disponibles están ajustar y obtener la posición del cursor y la lectura de texto.

Tabla 5-31 PresentationSpace

MÉTODOS

getCursorPosition()

Devuelve una instancia Posición que representa la posición actual del cursor. Una sesión no conectada tiene una posición de cursor de 0,0.

Devuelve

{Position} posición actual del cursor

setCursorPosition(position)

Mueve el cursor del host a la posición de fila y columna especificado. En algunos hosts, como los VT, el host puede restringir los movimientos del cursor.

Parámetros

{Position} Posición nueva posición del cursor.

Devuelve

Nada

Arroja

{RangeError} Si la posición no es válida en la pantalla actual.

isCursorVisible()

Comprueba que el cursor está actualmente visible en el espacio de presentación. El cursor se considera no visible si la sesión no está conectada.

Devuelve

{Boolean}True si el cursor está visible. False si el cursor no está visible.

sendKeys(keys)

Transmite una cadena de texto o ControlKey al host en la posición actual del cursor en el espacio de presentación. Si el cursor no se encuentra en la posición deseada, utilice primero la función setCursorPosition.

La cadena de texto puede contener cualquier número de caracteres y objetos ControlKey.

Por ejemplo: "myname" + ControlKey.TAB + "mypass" + ControlKey.ENTER transmitirá un ID de usuario, tabulación al campo siguiente, transmite una contraseña y transmite entonces la tecla Intro.

Si necesita transmitir un corchete, duplique los corchetes ([[ o ]]).

Parámetros

{String} texto de tecla y/o teclas de control a transmitir

getText(start,length)

Devuelve una cadena que representa un área lineal del espacio de presentación. Cuando se encuentran los límites de la fila, no se insertan caracteres de nueva línea.

Parámetros

{Position} posición inicial desde la que se debe recuperar texto

{Number} longitud del número máximo de caracteres a devolver. Si el parámetro de longitud hace que se exceda la última posición del espacio de presentación, sólo se devuelven los caracteres hasta la última posición.

Devuelve

{String) que representa un área lineal del espacio de presentación que puede estar vacía si la sesión no está conectada.

Arroja

{RangeError} Si la posición o la longitud no son válidas en la pantalla actual.

getSize()

Obtiene las dimensiones de la pantalla como objeto Dimension.

Devuelve

{Dimension} Que contiene el número de filas y columnas. El tamaño de la pantalla es [row:0, col:0] si la sesión no está conectada.

getDataCells(start, length)

Devuelve instancias DataCell en las que el primer miembro será para la posición especificada por el parámetro de inicio. El número máximo de instancias DataCell en la lista viene especificado por el parámetro de longitud.

Parámetros

{Position} inicio de la primera posición en la pantalla del host en la que se recuperan instancias DataCell. Véase Posición.

{Number} longitud del número máximo de instancias DataCell a recuperar. Si no se especifica, devuelve DataCells de la posición inicial a la posición final de la pantalla.

Devuelve

Instancias {DataCell[]} que pueden estar vacías si la sesión no está conectada. Si la posición no está especificada, devuelve todas las DataCells. Si la longitud no se especifica, devuelve DataCells de la posición inicial a la posición final de la pantalla.

Arroja

{RangeError} si inicio o longitud están fuera de rango.

getFields()

Devuelve una lista de los campos en el espacio de presentación. Si el tipo de host no soporta campos o si la pantalla actual no está formateada el valor de retorno será siempre una lista vacía. Véase FieldList.

Devuelve

{FieldList} de los campos definidos del host en el espacio de presentación.