Ekran#

Wstęp#

Klasa ekranu screen jest klasą pochodną klasy controller. Zapewnia funkcje do wyświetlania tekstu, liczb i wartości na ekranie kontrolera V5.

A screen object is accessed through a controller object. It is not constructed directly.

Ekran kontrolera V5 ma 3 wiersze i 19 kolumn służących do wyświetlania tekstu i liczb.

Zrzut ekranu kontrolera V5, pokazujący wiersze i kolumny w obszarze wydruku. Wiersz 1, kolumna 1 zaczynają się w lewym górnym rogu, a wiersz 3, kolumna 19, znajdują się w prawym dolnym rogu.

Dostęp#

Klasa kontrolera controller udostępnia obiekt Screen Jest to instancja klasy screen.

Obiekt

Przykładowe użycie

Opis

Screen

Controller.Screen.print(“Hello”);

Ekran kontrolera V5.

Notatki#

  • Przed użyciem funkcji członkowskiej ekranu screen utwórz obiekt kontrolera controller.

  • Ekran kontrolera ma 3 wiersze i 19 kolumn.

  • Pozycja kursora określa miejsce, w którym pojawi się następna wydrukowana wartość.

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

Funkcje członkowskie#

Klasa ekranu screen zawiera następujące funkcje członkowskie:

Akcje — wyświetl tekst lub wyczyść ekran kontrolera.

  • print — Wyświetla sformatowany tekst, liczby lub wartości na ekranie kontrolera.

  • setCursor — Przenosi kursor do określonego wiersza i kolumny.

  • newLine — Czyści resztę bieżącego wiersza i przenosi kursor do następnego wiersza.

  • clearScreen — Czyści ekran kontrolera.

  • clearLine — Czyści jeden wiersz na ekranie kontrolera.

Gettery — odczytują bieżącą pozycję kursora.

  • row — Zwraca bieżący wiersz kursora.

  • column — Zwraca bieżącą kolumnę kursora.

Akcje#

print#

print wyświetla sformatowany tekst, liczby lub wartości na ekranie kontrolera V5 w bieżącej pozycji kursora.

Dostępne funkcje

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


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

Parametr

Typ

Opis

format

const char*

Ciąg formatujący podany jako literał ciągu lub ciąg tylko do odczytu w stylu języka C, np. “Score: %d”.

format

char*

Ciąg formatujący podany jako modyfikowalna tablica znaków.

…

Opcjonalnie. Do ciągu formatującego należy wstawić jedną lub więcej dodatkowych wartości, rozdzielonych przecinkami.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Notatki

  • Dane wyjściowe rozpoczynają się w bieżącej pozycji kursora na ekranie kontrolera.

  • W przypadku używania ciągu formatującego liczba i typy przekazywanych wartości muszą odpowiadać specyfikatorom formatu w ciągu.

Przykład

// 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 przesuwa kursor do określonego wiersza i kolumny na ekranie kontrolera V5. W tym miejscu pojawi się następna wydrukowana wartość.

Dostępna funkcja

void setCursor(
  int32_t row,
  int32_t col
);

Parametr

Typ

Opis

row

int32_t

Numer wiersza, w którym zostanie umieszczony kursor, od 1 do 3.

col

int32_t

Numer kolumny, w której zostanie umieszczony kursor, od 1 do 19.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Przykład

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

newLine#

newLine czyści resztę bieżącego wiersza i przenosi kursor do kolumny 1 w następnym wierszu ekranu kontrolera V5.

Dostępna funkcja

void newLine();

Parametry

Ta funkcja nie ma parametrów.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Przykład

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

clearScreen#

clearScreen usuwa cały tekst z ekranu kontrolera V5.

Dostępna funkcja

void clearScreen();

Parametry

Ta funkcja nie ma parametrów.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Przykład

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

clearLine#

clearLine czyści jeden wiersz na ekranie kontrolera V5.

Dostępne funkcje

void clearLine(
  int line
);


void clearLine();

Parametr

Typ

Opis

line

int

Opcjonalnie. Wiersz do wyczyszczenia, od 1 do 3Jeśli nie podano wiersza, wyczyszczony zostanie wiersz bieżący.

Wartość zwracana

Ta funkcja nie zwraca wartości.

Notatki

  • Wyczyszczenie wiersza nie zmienia aktualnej pozycji kursora.

Przykład

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

Getters#

row#

row zwraca bieżący wiersz kursora na ekranie kontrolera V5.

Dostępna funkcja

int32_t row();

Parametry

Ta funkcja nie ma parametrów.

Wartość zwracana

Zwraca wartość int32_t reprezentującą bieżący wiersz kursora. Numeracja wierszy zaczyna się od 1.

Przykład

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

column#

column zwraca bieżącą kolumnę kursora na ekranie kontrolera V5.

Dostępna funkcja

int32_t column();

Parametry

Ta funkcja nie ma parametrów.

Wartość zwracana

Zwraca wartość int32_t reprezentującą bieżącą kolumnę kursora. Numeracja kolumn zaczyna się od 1.

Przykład

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