Ecrã

Introdução

A classe screen é uma classe derivada da classe controller. Fornece funções para exibir texto, números e valores no ecrã do Controlador V5.

A screen object is accessed through a controller object. It is not constructed directly.

O ecrã do controlador V5 possui 3 linhas e 19 colunas para apresentar texto e números.

Acesso

A classe controller fornece um objeto Screen É uma instância da classe screen.

Objeto	Exemplo de utilização	Descrição
Screen	Controller.Screen.print(“Hello”);	O ecrã do controlador V5.

Notas

• Antes de utilizar uma função membro screen , crie um objecto controller.

• O ecrã do controlador possui 3 linhas e 19 colunas.

• A posição do cursor determina o local onde o próximo valor impresso irá aparecer.

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

Funções de membro

A classe screen inclui as seguintes funções membro:

Ações — Visualizar texto ou limpar o ecrã do Controlador.

• print — Apresenta texto formatado, números ou valores no ecrã do Controlador.

• setCursor — Move o cursor para uma linha e coluna especificadas.

• newLine — Limpa o resto da linha actual e move o cursor para a linha seguinte.

• clearScreen — Limpa o ecrã do Controlador.

• clearLine — Limpa uma linha no ecrã do Controlador.

Getters — Leem a posição atual do cursor.

• row — Retorna a linha actual do cursor.

• column — Retorna a coluna actual do cursor.

Ações

print

print apresenta texto formatado, números ou valores no ecrã do Controlador V5 na posição actual do cursor.

Funções disponíveis

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

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

Parâmetro	Tipo	Descrição
format	const char*	Uma string de formato fornecida como uma string literal ou string de leitura apenas no estilo C, como “Score: %d”.
format	char*	Uma string de formatação fornecida como uma matriz de caracteres modificável.
…		Opcional. Um ou mais valores adicionais introduzidos na cadeia de formato, separados por vírgulas.

Valor de Retorno

Esta função não devolve qualquer valor.

Notas

• A saída começa na posição atual do cursor no ecrã do Controlador.

• Quando se utiliza uma string de formato, o número e os tipos de valores passados ​​devem corresponder aos especificadores de formato na string.

Exemplo

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

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

setCursor

O comando setCursor move o cursor para uma linha e coluna específicas no ecrã do Controlador V5. O próximo valor impresso aparecerá nessa posição.

Função disponível

void setCursor(
  int32_t row,
  int32_t col
);

Parâmetro	Tipo	Descrição
row	int32_t	O número da linha onde o cursor será posicionado, de 1 a 3.
col	int32_t	O número da coluna onde o cursor será posicionado, de 1 a 19.

Valor de Retorno

Esta função não devolve qualquer valor.

Exemplo

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

newLine

newLine limpa o resto da linha actual e move o cursor para a coluna 1 na linha seguinte do ecrã do Controlador V5.

Função disponível

void newLine();

Parâmetros

Esta função não tem parâmetros.

Valor de Retorno

Esta função não devolve qualquer valor.

Exemplo

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

clearScreen

clearScreen limpa todo o texto do ecrã do Controlador V5.

Função disponível

void clearScreen();

Parâmetros

Esta função não tem parâmetros.

Valor de Retorno

Esta função não devolve qualquer valor.

Exemplo

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

clearLine

clearLine limpa uma linha no ecrã do Controlador V5.

Funções disponíveis

void clearLine(
  int line
);

void clearLine();

Parâmetro	Tipo	Descrição
line	int	Opcional. A linha a limpar, de 1 a 3Se não for fornecida nenhuma linha, a linha actual será limpa.

Valor de Retorno

Esta função não devolve qualquer valor.

Notas

• A limpeza de uma linha não altera a posição atual do cursor.

Exemplo

// 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

A linha row devolvem a linha atual do cursor no ecrã do Controlador V5.

Função disponível

int32_t row();

Parâmetros

Esta função não tem parâmetros.

Valor de Retorno

Retorna um int32_t que representa a linha actual do cursor. A numeração das linhas começa em 1.

Exemplo

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

column

column returns the current cursor column on the V5 Controller screen.

Função disponível

int32_t column();

Parâmetros

Esta função não tem parâmetros.

Valor de Retorno

Retorna um int32_t que representa a coluna atual do cursor. A numeração das colunas começa em 1.

Exemplo

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