Ekrāns

Ievads

screen klase ir atvasināta no controller klases. Tā nodrošina funkcijas teksta, skaitļu un vērtību attēlošanai V5 kontrollera ekrānā.

screen objektam piekļūst, izmantojot controller objektu. Tas netiek konstruēts tieši.

V5 kontrollera ekrānā ir 3 rindas un 19 kolonnas teksta un skaitļu attēlošanai.

Piekļuve

controller klase nodrošina Screen objektu. Tā ir screen klases instance.

Objekts	Lietošanas piemērs	Apraksts
Screen	Controller.Screen.print(“Hello”);	V5 kontrollera ekrāns.

Piezīmes

• Pirms screen dalībnieka funkcijas izmantošanas izveidojiet controller objektu.

• Kontroliera ekrānā ir 3 rindas un 19 kolonnas.

• Kursora pozīcija nosaka, kur parādīsies nākamā drukātā vērtība.

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

Dalībnieku funkcijas

screen klasē ir iekļautas šādas dalībfunkcijas:

Darbības — parādīt tekstu vai notīrīt kontrollera ekrānu.

• print — Kontroliera ekrānā parāda formatētu tekstu, skaitļus vai vērtības.

• setCursor — Pārvieto kursoru uz norādīto rindu un kolonnu.

• newLine — Notīra atlikušo pašreizējās rindas daļu un pārvieto kursoru uz nākamo rindu.

• clearScreen — Notīra kontrollera ekrānu.

• clearLine — Notīra vienu rindu kontrollera ekrānā.

Ieguvēji — nolasa pašreizējo kursora pozīciju.

• row rinda — Atgriež pašreizējo kursora rindu.

• column — Atgriež pašreizējo kursora kolonnu.

Darbības

print

print parāda formatētu tekstu, skaitļus vai vērtības V5 kontrollera ekrānā pašreizējā kursora pozīcijā.

Pieejamās funkcijas

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

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

Parametrs	Tips	Apraksts
format	const char*	Formāta virkne, kas norādīta kā virknes literālis vai tikai lasāma C stila virkne, piemēram, “Score: %d”.
format	char*	Formāta virkne, kas norādīta kā modificējams rakstzīmju masīvs.
…		Neobligāti. Formāta virknē ievietota viena vai vairākas papildu vērtības, atdalītas ar komatiem.

Atgriešanas vērtība

Šī funkcija neatgriež vērtību.

Piezīmes

• Izvade sākas pašreizējā kursora pozīcijā kontrollera ekrānā.

• Izmantojot formāta virkni, nodoto vērtību skaitam un tipiem ir jāatbilst virknes formāta specifikatoriem.

Piemērs

// 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 pārvieto kursoru uz norādīto rindu un kolonnu V5 kontrollera ekrānā. Nākamā drukātā vērtība parādīsies šajā pozīcijā.

Pieejamās funkcijas

void setCursor(
  int32_t row,
  int32_t col
);

Parametrs	Tips	Apraksts
row	int32_t	Rindas numurs, kurā tiks novietots kursors, no 1 līdz 3.
col	int32_t	Kolonnas numurs, kurā tiks novietots kursors, no 1 līdz 19.

Atgriešanas vērtība

Šī funkcija neatgriež vērtību.

Piemērs

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

newLine

newLine notīra atlikušo pašreizējās rindas daļu un pārvieto kursoru uz 1. kolonnu nākamajā V5 kontrollera ekrāna rindā.

Pieejamās funkcijas

void newLine();

Parametri

Šai funkcijai nav parametru.

Atgriešanas vērtība

Šī funkcija neatgriež vērtību.

Piemērs

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

clearScreen

clearScreen notīra visu tekstu no V5 kontrollera ekrāna.

Pieejamās funkcijas

void clearScreen();

Parametri

Šai funkcijai nav parametru.

Atgriešanas vērtība

Šī funkcija neatgriež vērtību.

Piemērs

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

clearLine

clearLine notīra vienu rindu V5 kontrollera ekrānā.

Pieejamās funkcijas

void clearLine(
  int line
);

void clearLine();

Parametrs	Tips	Apraksts
line	int	Neobligāti. Rinda, kas jātīra, no 1 līdz 3Ja rinda nav norādīta, tiek notīrīta pašreizējā rinda.

Atgriešanas vērtība

Šī funkcija neatgriež vērtību.

Piezīmes

• Rindas notīrīšana nemaina pašreizējo kursora pozīciju.

Piemērs

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

Getteri

row

row  rinda atgriež pašreizējo kursora rindu V5 kontrollera ekrānā.

Pieejamās funkcijas

int32_t row();

Parametri

Šai funkcijai nav parametru.

Atgriešanas vērtība

Atgriež int32_t kas apzīmē pašreizējo kursora rindu. Rindu numerācija sākas ar 1.

Piemērs

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

column

column atgriež pašreizējo kursora kolonnu V5 kontrollera ekrānā.

Pieejamās funkcijas

int32_t column();

Parametri

Šai funkcijai nav parametru.

Atgriešanas vērtība

Atgriež int32_t kas apzīmē pašreizējo kursora kolonnu. Kolonnu numerācija sākas ar 1.

Piemērs

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