Ekranas

Įvadas

screen klasė yra išvestinė iš controller klasės. Ji teikia funkcijas tekstui, skaičiams ir reikšmėms rodyti V5 valdiklio ekrane.

screen objektas pasiekiamas per controller objektą. Jis nėra konstruojamas tiesiogiai.

V5 valdiklio ekrane yra 3 eilutės ir 19 stulpelių tekstui ir skaičiams rodyti.

Prieiga

controller klasė suteikia Screen objektą. Tai yra screen klasės egzempliorius.

Objektas	Naudojimo pavyzdys	Aprašymas
Screen	Controller.Screen.print(“Hello”);	V5 valdiklio ekranas.

Pastabos

• Prieš naudodami screen nario funkciją, sukurkite controller objektą.

• Valdiklio ekrane yra 3 eilutės ir 19 stulpelių.

• Žymeklio padėtis nustato, kur bus rodoma kita atspausdinta reikšmė.

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

Narių funkcijos

screen klasėje yra šios narinės funkcijos:

Veiksmai – rodyti tekstą arba išvalyti valdiklio ekraną.

• print – Valdiklio ekrane rodo suformatuotą tekstą, skaičius arba reikšmes.

• setCursor — Perkelia žymeklį į nurodytą eilutę ir stulpelį.

• newLine — Išvalo likusią dabartinės eilutės dalį ir perkelia žymeklį į kitą eilutę.

• clearScreen — Išvalo valdiklio ekraną.

• clearLine — Išvalo vieną eilutę valdiklio ekrane.

Getteriai – nuskaito dabartinę žymeklio padėtį.

• row — Grąžina dabartinę žymeklio eilutę.

• column — Grąžina dabartinį žymeklio stulpelį.

Veiksmai

print

print rodo suformatuotą tekstą, skaičius arba reikšmes V5 valdiklio ekrane dabartinėje žymeklio padėtyje.

Galimos funkcijos

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

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

Parametras	Tipas	Aprašymas
format	const char*	Formato eilutė, pateikta kaip eilutės literalas arba tik skaitymui skirta C stiliaus eilutė, pvz., “Score: %d”.
format	char*	Formato eilutė, pateikta kaip modifikuojamas simbolių masyvas.
…		Pasirinktinai. Į formato eilutę įterpta viena ar kelios papildomos reikšmės, atskirtos kableliais.

Grąžinimo vertė

Ši funkcija negrąžina reikšmės.

Pastabos

• Išvestis pradedama nuo dabartinės žymeklio pozicijos valdiklio ekrane.

• Naudojant formatavimo eilutę, perduodamų reikšmių skaičius ir tipai turi sutapti su eilutėje esančiais formato specifikacijomis.

Pavyzdys

// 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 perkelia žymeklį į nurodytą eilutę ir stulpelį V5 valdiklio ekrane. Kita atspausdinta reikšmė bus rodoma toje pozicijoje.

Galima funkcija

void setCursor(
  int32_t row,
  int32_t col
);

Parametras	Tipas	Aprašymas
row	int32_t	Eilutės numeris, kuriame bus patalpintas žymeklis, nuo 1 iki 3.
col	int32_t	Stulpelio, kuriame bus patalpintas žymeklis, numeris nuo 1 iki 19.

Grąžinimo vertė

Ši funkcija negrąžina reikšmės.

Pavyzdys

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

newLine

newLine išvalo likusią dabartinės eilutės dalį ir perkelia žymeklį į 1 stulpelį kitoje V5 valdiklio ekrano eilutėje.

Galima funkcija

void newLine();

Parametrai

Ši funkcija neturi parametrų.

Grąžinimo vertė

Ši funkcija negrąžina reikšmės.

Pavyzdys

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

clearScreen

clearScreen išvalo visą tekstą iš V5 valdiklio ekrano.

Galima funkcija

void clearScreen();

Parametrai

Ši funkcija neturi parametrų.

Grąžinimo vertė

Ši funkcija negrąžina reikšmės.

Pavyzdys

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

clearLine

clearLine išvalo vieną eilutę V5 valdiklio ekrane.

Galimos funkcijos

void clearLine(
  int line
);

void clearLine();

Parametras	Tipas	Aprašymas
line	int	Pasirinktinai. Eilutė, kurią reikia išvalyti, nuo 1 iki 3Jei eilutė nenurodyta, dabartinė eilutė išvaloma.

Grąžinimo vertė

Ši funkcija negrąžina reikšmės.

Pastabos

• Eilutės išvalymas nepakeičia dabartinės žymeklio pozicijos.

Pavyzdys

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

Getteriai

row

row grąžina dabartinę žymeklio eilutę V5 valdiklio ekrane.

Galima funkcija

int32_t row();

Parametrai

Ši funkcija neturi parametrų.

Grąžinimo vertė

Grąžina int32_t žymintį dabartinę žymeklio eilutę. Eilučių numeracija prasideda nuo 1.

Pavyzdys

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

column

column grąžina dabartinį žymeklio stulpelį V5 valdiklio ekrane.

Galima funkcija

int32_t column();

Parametrai

Ši funkcija neturi parametrų.

Grąžinimo vertė

Grąžina int32_t žymintį dabartinį žymeklio stulpelį. Stulpelių numeracija prasideda nuo 1.

Pavyzdys

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