Obrazovka#

Zavedení#

Třída screen je odvozenou třídou třídy controller. Poskytuje funkce pro zobrazení textu, čísel a hodnot na obrazovce V5 Controlleru.

K objektu screen se přistupuje přes objekt controller Není konstruován přímo.

Obrazovka ovladače V5 má 3 řádky a 19 sloupců pro zobrazení textu a čísel.

Snímek obrazovky řídicí jednotky V5 zobrazující řádky a sloupce v tisknutelné oblasti. Řádek 1 Sloupec 1 začíná v levém horním rohu a řádek 3 a sloupec 19 jsou v pravém dolním rohu.

Přístup#

Třída controller poskytuje objekt Screen Je to instance třídy screen.

Objekt

Příklad použití

Popis

Screen

Controller.Screen.print(“Hello”);

Obrazovka ovladače V5.

Poznámky#

  • Před použitím členské funkce screen vytvořte objekt controller.

  • Obrazovka ovladače má 3 řádky a 19 sloupců.

  • Pozice kurzoru určuje, kde se zobrazí další vytištěná hodnota.

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

Členské funkce#

Třída screen obsahuje následující členské funkce:

Akce – Zobrazení textu nebo vymazání obrazovky ovladače.

  • print — Zobrazí formátovaný text, čísla nebo hodnoty na obrazovce Controlleru.

  • setCursor — Přesune kurzor na zadaný řádek a sloupec.

  • newLine — Vymaže zbytek aktuálního řádku a přesune kurzor na další řádek.

  • clearScreen — Vymaže obrazovku ovladače.

  • clearLine — Vymaže jeden řádek na obrazovce Controlleru.

Gettery – Čtou aktuální pozici kurzoru.

  • row — Vrátí aktuální řádek kurzoru.

  • column — Vrátí aktuální sloupec kurzoru.

Akce#

print#

print zobrazí formátovaný text, čísla nebo hodnoty na obrazovce Controlleru V5 v aktuální pozici kurzoru.

Dostupné funkce

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


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

Parametr

Typ

Popis

format

const char*

Formátovací řetězec zadaný jako řetězcový literál nebo řetězec ve stylu jazyka C určený pouze pro čtení, například “Score: %d”.

format

char*

Formátovací řetězec poskytnutý jako modifikovatelné pole znaků.

…

Volitelné. Do formátovacího řetězce se vkládá jedna nebo více dalších hodnot oddělených čárkami.

Návratová hodnota

Tato funkce nevrací hodnotu.

Poznámky

  • Výstup začíná na aktuální pozici kurzoru na obrazovce Controlleru.

  • Při použití formátovacího řetězce se musí počet a typy předávaných hodnot shodovat se specifikacemi format specificiers v řetězci.

Příklad

// 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řesune kurzor na zadaný řádek a sloupec na obrazovce řídicí jednotky V5. Na této pozici se zobrazí další vytištěná hodnota.

Dostupná funkce

void setCursor(
  int32_t row,
  int32_t col
);

Parametr

Typ

Popis

row

int32_t

Číslo řádku, kde bude umístěn kurzor, od 1 do 3.

col

int32_t

Číslo sloupce, kde bude umístěn kurzor, od 1 do 19.

Návratová hodnota

Tato funkce nevrací hodnotu.

Příklad

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

newLine#

Příkaz newLine vymaže zbytek aktuálního řádku a přesune kurzor do sloupce 1 na dalším řádku obrazovky ovladače V5.

Dostupná funkce

void newLine();

Parametry

Tato funkce nemá parametry.

Návratová hodnota

Tato funkce nevrací hodnotu.

Příklad

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

clearScreen#

clearScreen vymaže veškerý text z obrazovky ovladače V5.

Dostupná funkce

void clearScreen();

Parametry

Tato funkce nemá parametry.

Návratová hodnota

Tato funkce nevrací hodnotu.

Příklad

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

clearLine#

clearLine vymaže jeden řádek na obrazovce řídicí jednotky V5.

Dostupné funkce

void clearLine(
  int line
);


void clearLine();

Parametr

Typ

Popis

line

int

Volitelné. Řádek, který se má vymazat, od 1 do 3Pokud není zadán žádný řádek, vymaže se aktuální řádek.

Návratová hodnota

Tato funkce nevrací hodnotu.

Poznámky

  • Vymazání řádku nezmění aktuální pozici kurzoru.

Příklad

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

Gettery#

row#

row vrací aktuální řádek kurzoru na obrazovce Controlleru V5.

Dostupná funkce

int32_t row();

Parametry

Tato funkce nemá parametry.

Návratová hodnota

Vrací hodnotu int32_t představující aktuální řádek kurzoru. Číslování řádků začíná na 1.

Příklad

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

column#

column vrací aktuální sloupec kurzoru na obrazovce řídicí jednotky V5.

Dostupná funkce

int32_t column();

Parametry

Tato funkce nemá parametry.

Návratová hodnota

Vrací hodnotu int32_t představující aktuální sloupec kurzoru. Číslování sloupců začíná na 1.

Příklad

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