Экран#

Введение#

Класс 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*

Форматная строка, представленная в виде изменяемого символьного массива.

…

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

Возвращаемая стоимость

Эта функция не возвращает значения.

Примечания

  • Вывод начинается с текущей позиции курсора на экране контроллера.

  • При использовании строки формата количество и типы передаваемых значений должны соответствовать спецификаторам формата в строке.

Пример

// 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());
На этой странице