หน้าจอ

การแนะนำ

คลาส screen เป็นคลาสที่สืบทอดมาจากคลาส controller โดยมีฟังก์ชันสำหรับแสดงข้อความ ตัวเลข และค่าต่างๆ บนหน้าจอ V5 Controller

อ็อบเจ็กต์หน้าจอ screen จะถูกเข้าถึงผ่านอ็อบเจ็กต์ตัวควบคุม controller โดยไม่ได้สร้างขึ้นโดยตรง

หน้าจอของตัวควบคุม V5 มี 3 แถวและ 19 คอลัมน์ สำหรับแสดงข้อความและตัวเลข

เข้าถึง

คลาสคอนโทรลเลอร์ controller ให้วัตถุ Screen ซึ่งเป็นอินสแตนซ์ของคลาส screen

วัตถุ	ตัวอย่างการใช้งาน	คำอธิบาย
Screen	Controller.Screen.print(“Hello”);	หน้าจอคอนโทรลเลอร์ V5

หมายเหตุ

• ก่อนใช้งานฟังก์ชันสมาชิก screen ให้สร้างอ็อบเจ็กต์ controller ก่อน

• หน้าจอ Controller มี 3 แถวและ 19 คอลัมน์

• ตำแหน่งของเคอร์เซอร์จะเป็นตัวกำหนดว่าค่าที่พิมพ์ถัดไปจะปรากฏที่ใด

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

ฟังก์ชันสมาชิก

คลาส screen ประกอบด้วยฟังก์ชันสมาชิกต่อไปนี้:

การดำเนินการ — แสดงข้อความหรือล้างหน้าจอควบคุม

• print — แสดงข้อความ ตัวเลข หรือค่าที่จัดรูปแบบบนหน้าจอ Controller

• setCursor — ย้ายเคอร์เซอร์ไปยังแถวและคอลัมน์ที่ระบุ

• newLine — ล้างส่วนที่เหลือของแถวปัจจุบันและย้ายเคอร์เซอร์ไปยังแถวถัดไป

• clearScreen — ล้างหน้าจอ Controller

• clearLine — ล้างแถวหนึ่งแถวบนหน้าจอ Controller

Getters — อ่านตำแหน่งเคอร์เซอร์ปัจจุบัน

• row — ส่งคืนแถวเคอร์เซอร์ปัจจุบัน

• column — ส่งคืนคอลัมน์เคอร์เซอร์ปัจจุบัน

การกระทำ

print

คำสั่ง print จะแสดงข้อความ ตัวเลข หรือค่าที่จัดรูปแบบแล้วบนหน้าจอ V5 Controller ณ ตำแหน่งเคอร์เซอร์ปัจจุบัน

ฟังก์ชันที่มีให้ใช้งาน

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 Controller ค่าที่พิมพ์ถัดไปจะปรากฏที่ตำแหน่งนั้น

ฟังก์ชันที่มีให้ใช้งาน

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 Controller

ฟังก์ชันที่มีให้ใช้งาน

void newLine();

พารามิเตอร์

ฟังก์ชันนี้ไม่มีพารามิเตอร์

ค่าที่ส่งคืน

ฟังก์ชันนี้ไม่ส่งค่ากลับ

ตัวอย่าง

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

clearScreen

clearScreen จะล้างข้อความทั้งหมดออกจากหน้าจอ V5 Controller

ฟังก์ชันที่มีให้ใช้งาน

void clearScreen();

พารามิเตอร์

ฟังก์ชันนี้ไม่มีพารามิเตอร์

ค่าที่ส่งคืน

ฟังก์ชันนี้ไม่ส่งค่ากลับ

ตัวอย่าง

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

clearLine

clearLine ล้างแถวหนึ่งแถวบนหน้าจอ V5 Controller

ฟังก์ชันที่มีให้ใช้งาน

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 Controller

ฟังก์ชันที่มีให้ใช้งาน

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 Controller

ฟังก์ชันที่มีให้ใช้งาน

int32_t column();

พารามิเตอร์

ฟังก์ชันนี้ไม่มีพารามิเตอร์

ค่าที่ส่งคืน

ส่งคืนค่า int32_t ซึ่งแทนคอลัมน์เคอร์เซอร์ปัจจุบัน การนับหมายเลขคอลัมน์เริ่มต้นที่ 1

ตัวอย่าง

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