Pantalla

Introducción

La clase screen es una clase derivada de la clase controller. Proporciona funciones para mostrar texto, números y valores en la pantalla del controlador V5.

Se accede a un objeto de pantalla screen a través de un objeto de controlador controller No se construye directamente.

La pantalla del controlador V5 tiene 3 filas y 19 columnas para mostrar texto y números.

Acceso

La clase controller proporciona un objeto Screen. Es una instancia de la clase screen.

Objeto	Ejemplo de uso	Descripción
Screen	Controller.Screen.print(“Hello”);	La pantalla del controlador V5.

Observaciones

• Before using a screen member function, create a controller object.

• La pantalla del controlador tiene 3 filas y 19 columnas.

• La posición del cursor determina dónde aparece el siguiente valor impreso.

// Create a Controller object
controller Controller = controller();

Funciones de los miembros

La clase screen incluye las siguientes funciones miembro:

Acciones: muestra texto o borra la pantalla del controlador.

• print — Muestra texto, números o valores formateados en la pantalla del controlador.

• setCursor — Mueve el cursor a una fila y columna especificadas.

• newLine: borra el resto de la fila actual y mueve el cursor a la siguiente fila.

• clearScreen — Borra la pantalla del controlador.

• clearLine: borra una fila en la pantalla del controlador.

Getters: lee la posición actual del cursor.

• row — Devuelve la fila del cursor actual.

• column — Devuelve la columna del cursor actual.

Acciones

print

print muestra texto, números o valores formateados en la pantalla del controlador V5 en la posición actual del cursor.

Funciones disponibles

void print(
  const char* format,
  ...
);

void print(
  char* format,
  ...
);

Parámetro	Tipo	Descripción
format	const char*	Una cadena de formato proporcionada como un literal de cadena o una cadena de estilo C de solo lectura, como “Score: %d”.
format	char*	Una cadena de formato proporcionada como una matriz de caracteres modificable.
…		Opcional. Uno o más valores adicionales insertados en la cadena de formato, separados por comas.

Valor de devolución

Esta función no devuelve un valor.

Notas

• La salida comienza en la posición actual del cursor en la pantalla del controlador.

• Cuando se utiliza una cadena de formato, el número y los tipos de valores pasados deben coincidir con los especificadores de formato en la cadena.

Ejemplo

// Display a message at the starting cursor position
Controller.Screen.print("Hello, Robot!");

// Display a formatted number
Controller.Screen.print("Score: %d", 25);

setCursor

setCursor mueve el cursor a una fila y columna especificadas en la pantalla del controlador V5. El siguiente valor impreso aparecerá en esa posición.

Función disponible

void setCursor(
  int32_t row,
  int32_t col
);

Parámetro	Tipo	Descripción
row	int32_t	El número de fila donde se colocará el cursor, del 1 al 3.
col	int32_t	El número de columna donde se colocará el cursor, del 1 al 19.

Valor de devolución

Esta función no devuelve un valor.

Ejemplo

// Display text starting at row 2, column 3
Controller.Screen.setCursor(2, 3);
Controller.Screen.print("Row 2, Column 3");

newLine

newLine borra el resto de la fila actual y mueve el cursor a la columna 1 en la siguiente fila de la pantalla del controlador V5.

Función disponible

void newLine();

Parámetros

Esta función no tiene parámetros.

Valor de devolución

Esta función no devuelve un valor.

Ejemplo

// Display two lines of text
Controller.Screen.print("Line 1");
Controller.Screen.newLine();
Controller.Screen.print("Line 2");

clearScreen

clearScreen borra todo el texto de la pantalla del controlador V5.

Función disponible

void clearScreen();

Parámetros

Esta función no tiene parámetros.

Valor de devolución

Esta función no devuelve un valor.

Ejemplo

// Clear the Controller screen after 2 seconds
Controller.Screen.print("VEXcode");
wait(2, seconds);
Controller.Screen.clearScreen();

clearLine

clearLine borra una fila en la pantalla del controlador V5.

Funciones disponibles

void clearLine(
  int line
);

void clearLine();

Parámetro	Tipo	Descripción
line	int	Opcional. La fila a borrar, de 1 a 3. Si no se proporciona ninguna fila, se borra la fila actual.

Valor de devolución

Esta función no devuelve un valor.

Notas

• Borrar una fila no cambia la posición actual del cursor.

Ejemplo

// Display text on two rows
Controller.Screen.print("This text stays");
Controller.Screen.newLine();
Controller.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Controller.Screen.clearLine(2);

Getters

row

la row devuelve la fila del cursor actual en la pantalla del controlador V5.

Función disponible

int32_t row();

Parámetros

Esta función no tiene parámetros.

Valor de devolución

Devuelve un int32_t que representa la fila del cursor actual. La numeración de filas comienza en 1.

Ejemplo

// Display the cursor's current row
Controller.Screen.setCursor(3, 2);
Controller.Screen.print(Controller.Screen.row());

column

column devuelve la columna del cursor actual en la pantalla del controlador V5.

Función disponible

int32_t column();

Parámetros

Esta función no tiene parámetros.

Valor de devolución

Devuelve un int32_t que representa la columna del cursor actual. La numeración de columnas comienza en 1.

Ejemplo

// Display the cursor's current column
Controller.Screen.setCursor(3, 2);
Controller.Screen.print(Controller.Screen.column());