Екран#

Вступ#

Клас screen є похідним класом від класу controller. Він надає функції для відображення тексту, чисел та значень на екрані контролера V5.

Доступ до об’єкта screen здійснюється через об’єкт controller Він не створюється безпосередньо.

Екран контролера V5 має 3 рядки та 19 стовпців для відображення тексту та чисел.

Знімок екрана контролера V5, на якому показано рядки та стовпці в області друку. Рядок 1. Стовпець 1 починається у верхньому лівому куті, а рядок 3 та стовпець 19 знаходяться в нижньому правому куті.

Доступ#

The controller class provides a Screen object. It is an instance of the screen class.

Об’єкт

Приклад використання

Опис

Screen

Controller.Screen.print(“Hello”);

Екран контролера V5.

Нотатки#

  • Перш ніж використовувати функцію-член screen , створіть об’єкт controller.

  • Екран контролера має 3 рядки та 19 стовпців.

  • Позиція курсора визначає, де з’явиться наступне надруковане значення.

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

Функції-члени#

Клас screen містить такі функції-члени:

Дії — Відображення тексту або очищення екрана контролера.

  • print — Відображає форматований текст, числа або значення на екрані контролера.

  • setCursor — Переміщує курсор до вказаного рядка та стовпця.

  • newLine — Очищає решту поточного рядка та переміщує курсор до наступного рядка.

  • clearScreen — Очищає екран контролера.

  • clearLine — Очищає один рядок на екрані контролера.

Геттери — Зчитують поточну позицію курсора.

  • row — Повертає поточний рядок курсора.

  • column — Повертає поточний стовпець курсора.

Дії#

print#

print відображає відформатований текст, числа або значення на екрані контролера V5 у поточній позиції курсора.

Доступні функції

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


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

Параметр

Тип

Опис

format

const char*

Рядок форматування, наданий як рядковий літерал або рядок у стилі C лише для читання, наприклад “Score: %d”.

format

char*

Рядок форматування, наданий як змінний масив символів.

…

Необов’язково. Одне або кілька додаткових значень, вставлених у рядок форматування, розділених комами.

Повернене значення

Ця функція не повертає значення.

Примітки

  • Вивід починається з поточної позиції курсора на екрані контролера.

  • Під час використання рядка форматування кількість та типи переданих значень повинні збігатися зі специфікаторами формату format specificiers у рядку.

Приклад

// 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 переміщує курсор до вказаного рядка та стовпця на екрані контролера V5. Наступне надруковане значення з’явиться в цій позиції.

Доступна функція

void setCursor(
  int32_t row,
  int32_t col
);

Параметр

Тип

Опис

row

int32_t

Номер рядка, де буде розміщено курсор, від 1 до 3.

col

int32_t

Номер стовпця, де буде розміщено курсор, від 1 до 19.

Повернене значення

Ця функція не повертає значення.

Приклад

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

newLine#

newLine очищає решту поточного рядка та переміщує курсор до стовпця 1 у наступному рядку екрана контролера V5.

Доступна функція

void newLine();

Параметри

Ця функція не має параметрів.

Повернене значення

Ця функція не повертає значення.

Приклад

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

clearScreen#

clearScreen очищає весь текст з екрана контролера V5.

Доступна функція

void clearScreen();

Параметри

Ця функція не має параметрів.

Повернене значення

Ця функція не повертає значення.

Приклад

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

clearLine#

clearLine очищає один рядок на екрані контролера V5.

Доступні функції

void clearLine(
  int line
);


void clearLine();

Параметр

Тип

Опис

line

int

Необов’язково. Рядок, який потрібно очистити, від 1 до 3Якщо рядок не вказано, очищається поточний рядок.

Повернене значення

Ця функція не повертає значення.

Примітки

  • Очищення рядка не змінює поточну позицію курсора.

Приклад

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

Геттери#

row#

row повертає поточний рядок курсора на екрані контролера V5.

Доступна функція

int32_t row();

Параметри

Ця функція не має параметрів.

Повернене значення

Повертає значення int32_t яке представляє поточний рядок курсора. Нумерація рядків починається з 1.

Приклад

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

column#

column повертає поточний стовпець курсора на екрані контролера V5.

Доступна функція

int32_t column();

Параметри

Ця функція не має параметрів.

Повернене значення

Повертає значення int32_t яке представляє поточний стовпець курсора. Нумерація стовпців починається з 1.

Приклад

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