Képernyő

Bevezetés

A screen osztály a controller osztály származtatott osztálya. Függvényeket biztosít szöveg, számok és értékek megjelenítéséhez a V5 Controller képernyőjén.

Egy screen objektumhoz egy controller objektumon keresztül lehet hozzáférni. Ez nem közvetlenül jön létre.

A V5 vezérlő képernyője 3 sorral és 19 oszloppal rendelkezik a szöveg és a számok megjelenítéséhez.

Hozzáférés

A controller osztály egy Screen objektumot biztosít. Ez a screen osztály egy példánya.

Objektum	Példahasználat	Leírás
Screen	Controller.Screen.print(“Hello”);	A V5 vezérlő képernyője.

Megjegyzések

• Mielőtt screen tagfüggvényt használnánk, hozzunk létre egy controller objektumot.

• A Vezérlő képernyője 3 sorból és 19 oszlopból áll.

• A kurzor pozíciója határozza meg, hogy hol jelenik meg a következő kinyomtatott érték.

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

Tagfüggvények

A screen osztály a következő tagfüggvényeket tartalmazza:

Műveletek – Szöveg megjelenítése vagy a vezérlő képernyőjének törlése.

• print — Formázott szöveget, számokat vagy értékeket jelenít meg a Vezérlő képernyőjén.

• setCursor — A kurzort egy megadott sorra és oszlopba mozgatja.

• newLine — Törli az aktuális sor többi részét, és a kurzort a következő sorra helyezi.

• clearScreen — Törli a Vezérlő képernyőjét.

• clearLine — Töröl egy sort a Vezérlő képernyőjén.

Getterek — Olvassa be az aktuális kurzorpozíciót.

• row — Visszaadja az aktuális kurzor sorát.

• column — Visszaadja az aktuális kurzor oszlopát.

Műveletek

print

print parancs formázott szöveget, számokat vagy értékeket jelenít meg a V5 vezérlő képernyőjén az aktuális kurzorpozícióban.

Elérhető funkciók

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

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

Paraméter	Típus	Leírás
format	const char*	Egy formázó karakterlánc, amely karakterlánc literálként vagy csak olvasható C stílusú karakterláncként van megadva, például “Score: %d”.
format	char*	Módosítható karaktertömbként megadott formátumú karakterlánc.
…		Opcionális. Egy vagy több további érték beszúrva a formázó karakterláncba, vesszővel elválasztva.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Megjegyzések

• A kimenet a vezérlő képernyőjén lévő aktuális kurzorpozíciónál kezdődik.

• Formátumkarakterlánc használata esetén az átadott értékek számának és típusának meg kell egyeznie a karakterláncban található formátumspecifikátorok értékével.

Példa

// 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 parancs a kurzort a V5 vezérlő képernyőjének egy megadott sorára és oszlopára mozgatja. A következő kinyomtatott érték ezen a pozíción fog megjelenni.

Elérhető funkció

void setCursor(
  int32_t row,
  int32_t col
);

Paraméter	Típus	Leírás
row	int32_t	A sor száma, ahová a kurzort helyezni fogjuk, 1 től 3.
col	int32_t	Az oszlop száma, ahová a kurzort helyezni kell, 1 től 19 ig.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Példa

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

newLine

newLine parancs törli az aktuális sor többi részét, és a kurzort a V5 vezérlő képernyőjének következő sorának 1. oszlopába helyezi.

Elérhető funkció

void newLine();

Paraméterek

Ennek a függvénynek nincsenek paraméterei.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Példa

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

clearScreen

clearScreen parancs hatására az összes szöveg törlődik a V5 vezérlő képernyőjéről.

Elérhető funkció

void clearScreen();

Paraméterek

Ennek a függvénynek nincsenek paraméterei.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Példa

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

clearLine

clearLine parancs egy sort töröl a V5 vezérlő képernyőjén.

Elérhető funkciók

void clearLine(
  int line
);

void clearLine();

Paraméter	Típus	Leírás
line	int	Opcionális. A törlendő sor, 1 től 3. Ha nincs megadva sor, az aktuális sor törlődik.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Megjegyzések

• Egy sor törlése nem változtatja meg az aktuális kurzor pozícióját.

Példa

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

Getterek

row

row visszaadja az aktuális kurzor sorát a V5 vezérlő képernyőjén.

Elérhető funkció

int32_t row();

Paraméterek

Ennek a függvénynek nincsenek paraméterei.

Visszatérési érték

Egy int32_t értéket ad vissza, amely az aktuális kurzor sorát jelöli. A sorok számozása 1 -mal kezdődik.

Példa

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

column

column oszlop értéke a V5 vezérlő képernyőjén aktuális kurzor oszlopot adja vissza.

Elérhető funkció

int32_t column();

Paraméterek

Ennek a függvénynek nincsenek paraméterei.

Visszatérési érték

Egy int32_t értéket ad vissza, amely az aktuális kurzor oszlopát jelöli. Az oszlopok számozása 1 -mal kezdődik.

Példa

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