Näyttö

Johdanto

screen -luokka on controller -luokan johdettu luokka. Se tarjoaa funktioita tekstin, numeroiden ja arvojen näyttämiseen V5-ohjaimen näytöllä.

screen -objektiin päästään käsiksi controller -objektin kautta. Sitä ei konstruoida suoraan.

V5-ohjaimen näytössä on 3 riviä ja 19 saraketta tekstin ja numeroiden näyttämiseen.

Pääsy

controller -luokka tarjoaa Screen -objektin. Se on screen -luokan instanssi.

Esine	Esimerkki käytöstä	Kuvaus
Screen	Controller.Screen.print(“Hello”);	V5-ohjaimen näyttö.

Muistiinpanoja

• Ennen screen -jäsenfunktion käyttöä luo controller -objekti.

• Ohjaimen näytössä on 3 riviä ja 19 saraketta.

• Kohdistimen sijainti määrittää, mihin seuraava tulostettava arvo tulee.

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

Jäsenten toiminnot

screen -luokka sisältää seuraavat jäsenfunktiot:

Toiminnot — Näytä tekstiä tai tyhjennä ohjaimen näyttö.

• print — Näyttää muotoiltua tekstiä, numeroita tai arvoja ohjainnäytössä.

• setCursor — Siirtää kohdistimen määritettyyn riviin ja sarakkeeseen.

• newLine — Tyhjentää loput nykyisestä rivistä ja siirtää kohdistimen seuraavalle riville.

• clearScreen — Tyhjentää ohjainnäytön.

• clearLine — Tyhjentää yhden rivin ohjainnäytöltä.

Getterit — Lukevat kohdistimen nykyisen sijainnin.

• row — Palauttaa kohdistimen nykyisen rivin.

• column — Palauttaa kohdistimen nykyisen sarakkeen.

Toiminnot

print

print näyttää muotoiltua tekstiä, numeroita tai arvoja V5-ohjaimen näytöllä kohdistimen nykyisessä sijainnissa.

Käytettävissä olevat toiminnot

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

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

Parametri	Tyyppi	Kuvaus
format	const char*	Muotoilumerkkijono, joka on annettu merkkijonoliteraalina tai vain luettavana C-tyylisenä merkkijonona, kuten “Score: %d”.
format	char*	Muokattavana merkkijonona annettu muotoilumerkkijono.
…		Valinnainen. Muotoilumerkkijonoon lisätään yksi tai useampi lisäarvo pilkuilla erotettuna.

Palautusarvo

Tämä funktio ei palauta arvoa.

Huomautuksia

• Tuloste alkaa kohdistimen nykyisestä sijainnista ohjainnäytössä.

• Muotoilumerkkijonoa käytettäessä välitettävien arvojen lukumäärän ja tyyppien on vastattava merkkijonon muotoilumäärittelijöitä.

Esimerkki

// 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 siirtää kohdistimen V5-ohjaimen näytöllä määritettyyn riviin ja sarakkeeseen. Seuraava tulostettava arvo ilmestyy kyseiseen kohtaan.

Käytettävissä oleva toiminto

void setCursor(
  int32_t row,
  int32_t col
);

Parametri	Tyyppi	Kuvaus
row	int32_t	Rivinumero, johon kohdistin sijoitetaan, väliltä 1 - 3.
col	int32_t	Sarakkeen numero, johon kohdistin sijoitetaan, väliltä 1 - 19.

Palautusarvo

Tämä funktio ei palauta arvoa.

Esimerkki

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

newLine

newLine tyhjentää loput nykyisestä rivistä ja siirtää kohdistimen sarakkeeseen 1 V5-ohjainnäytön seuraavalla rivillä.

Käytettävissä oleva toiminto

void newLine();

Parametrit

Tällä funktiolla ei ole parametreja.

Palautusarvo

Tämä funktio ei palauta arvoa.

Esimerkki

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

clearScreen

clearScreen tyhjentää kaiken tekstin V5-ohjaimen näytöltä.

Käytettävissä oleva toiminto

void clearScreen();

Parametrit

Tällä funktiolla ei ole parametreja.

Palautusarvo

Tämä funktio ei palauta arvoa.

Esimerkki

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

clearLine

clearLine tyhjentää yhden rivin V5-ohjaimen näytöltä.

Käytettävissä olevat toiminnot

void clearLine(
  int line
);

void clearLine();

Parametri	Tyyppi	Kuvaus
line	int	Valinnainen. Tyhjennettävä rivi väliltä 1 - 3Jos riviä ei anneta, nykyinen rivi tyhjennetään.

Palautusarvo

Tämä funktio ei palauta arvoa.

Huomautuksia

• Rivin tyhjentäminen ei muuta kohdistimen nykyistä sijaintia.

Esimerkki

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

Getterit

row

row palauttaa nykyisen kursoririvin V5-ohjainnäytössä.

Käytettävissä oleva toiminto

int32_t row();

Parametrit

Tällä funktiolla ei ole parametreja.

Palautusarvo

Palauttaa arvon int32_t joka edustaa nykyistä kohdistimen riviä. Rivien numerointi alkaa numeroista 1.

Esimerkki

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

column

column palauttaa V5-ohjainnäytön nykyisen kohdistimen sarakkeen.

Käytettävissä oleva toiminto

int32_t column();

Parametrit

Tällä funktiolla ei ole parametreja.

Palautusarvo

Palauttaa arvon int32_t joka edustaa nykyistä kohdistimen saraketta. Sarakkeiden numerointi alkaa numeroista 1.

Esimerkki

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