Màn hình#

Giới thiệu#

Lớp màn hình screen là một lớp dẫn xuất của lớp controller. Nó cung cấp các chức năng để hiển thị văn bản, số và giá trị trên màn hình Bộ điều khiển V5.

Một đối tượng màn hình screen được truy cập thông qua một đối tượng bộ điều khiển controller Nó không được tạo trực tiếp.

Màn hình điều khiển V5 có 3 hàng và 19 cột để hiển thị văn bản và số.

Ảnh chụp màn hình giao diện điều khiển V5, hiển thị các hàng và cột trong vùng in. Hàng 1 Cột 1 bắt đầu ở góc trên bên trái và hàng 3, cột 19 nằm ở góc dưới bên phải.

Truy cập#

Lớp điều khiển controller cung cấp một đối tượng Màn hình Screen Nó là một thể hiện của lớp màn hình screen.

Sự vật

Ví dụ sử dụng

Sự miêu tả

Screen

Controller.Screen.print(“Hello”);

Màn hình điều khiển V5.

Ghi chú#

  • Trước khi sử dụng hàm thành viên màn hình screen , hãy tạo đối tượng bộ điều khiển controller.

  • Màn hình điều khiển có 3 hàng và 19 cột.

  • Vị trí con trỏ xác định vị trí hiển thị giá trị được in tiếp theo.

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

Chức năng thành viên#

Lớp màn hình screen bao gồm các hàm thành viên sau:

Thao tác — Hiển thị văn bản hoặc xóa màn hình Bộ điều khiển.

  • print — Hiển thị văn bản, số hoặc giá trị được định dạng trên màn hình Bộ điều khiển.

  • setCursor — Di chuyển con trỏ đến hàng và cột được chỉ định.

  • newLine — Xóa phần còn lại của hàng hiện tại và di chuyển con trỏ đến hàng tiếp theo.

  • clearScreen — Xóa màn hình Bộ điều khiển.

  • clearLine — Xóa một hàng trên màn hình Bộ điều khiển.

Getters — Đọc vị trí con trỏ hiện tại.

  • row — Trả về hàng con trỏ hiện tại.

  • column — Trả về cột con trỏ hiện tại.

Hành động#

print#

Lệnh print hiển thị văn bản, số hoặc giá trị được định dạng trên màn hình Bộ điều khiển V5 tại vị trí con trỏ hiện tại.

Các chức năng khả dụng

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


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

Tham số

Kiểu

Sự miêu tả

format

const char*

Chuỗi định dạng được cung cấp dưới dạng chuỗi ký tự hoặc chuỗi kiểu C chỉ đọc, chẳng hạn như “Score: %d”.

format

char*

Chuỗi định dạng được cung cấp dưới dạng mảng ký tự có thể chỉnh sửa.

…

Tùy chọn. Một hoặc nhiều giá trị bổ sung được chèn vào chuỗi định dạng, phân cách bằng dấu phẩy.

Giá trị trả về

Hàm này không trả về giá trị nào.

Ghi chú

  • Quá trình xuất dữ liệu bắt đầu từ vị trí con trỏ hiện tại trên màn hình Bộ điều khiển.

  • Khi sử dụng chuỗi định dạng, số lượng và loại giá trị được truyền phải khớp với định dạng chỉ định trong chuỗi.

Ví dụ

// Display a message at the starting cursor position
Controller.Screen.print("Hello, Robot!");


// Display a formatted number
Controller.Screen.print("Score: %d", 25);

setCursor#

Lệnh setCursor di chuyển con trỏ đến hàng và cột được chỉ định trên màn hình Bộ điều khiển V5. Giá trị được in tiếp theo sẽ xuất hiện tại vị trí đó.

Chức năng khả dụng

void setCursor(
  int32_t row,
  int32_t col
);

Tham số

Kiểu

Sự miêu tả

row

int32_t

Số thứ tự hàng mà con trỏ sẽ được đặt, từ 1 đến 3.

col

int32_t

Số thứ tự cột nơi con trỏ sẽ được đặt, từ 1 đến 19.

Giá trị trả về

Hàm này không trả về giá trị nào.

Ví dụ

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

newLine#

Lệnh newLine xóa phần còn lại của hàng hiện tại và di chuyển con trỏ đến cột 1 trên hàng tiếp theo của màn hình Bộ điều khiển V5.

Chức năng khả dụng

void newLine();

Thông số

Hàm này không có tham số.

Giá trị trả về

Hàm này không trả về giá trị nào.

Ví dụ

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

clearScreen#

clearScreen xóa tất cả văn bản khỏi màn hình Bộ điều khiển V5.

Chức năng khả dụng

void clearScreen();

Thông số

Hàm này không có tham số.

Giá trị trả về

Hàm này không trả về giá trị nào.

Ví dụ

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

clearLine#

Lệnh clearLine xóa một hàng trên màn hình Bộ điều khiển V5.

Các chức năng khả dụng

void clearLine(
  int line
);


void clearLine();

Tham số

Kiểu

Sự miêu tả

line

int

Tùy chọn. Hàng cần xóa, từ 1 đến 3Nếu không cung cấp hàng nào, hàng hiện tại sẽ bị xóa.

Giá trị trả về

Hàm này không trả về giá trị nào.

Ghi chú

  • Việc xóa một hàng không làm thay đổi vị trí con trỏ hiện tại.

Ví dụ

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

Người nhận#

row#

row trả về hàng con trỏ hiện tại trên màn hình Bộ điều khiển V5.

Chức năng khả dụng

int32_t row();

Thông số

Hàm này không có tham số.

Giá trị trả về

Trả về một giá trị int32_t biểu thị hàng con trỏ hiện tại. Số thứ tự hàng bắt đầu từ 1.

Ví dụ

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

column#

column trả về cột con trỏ hiện tại trên màn hình Bộ điều khiển V5.

Chức năng khả dụng

int32_t column();

Thông số

Hàm này không có tham số.

Giá trị trả về

Trả về một giá trị int32_t biểu thị cột con trỏ hiện tại. Số thứ tự cột bắt đầu từ 1.

Ví dụ

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