Layar#

Perkenalan#

Kelas screen adalah kelas turunan dari kelas controller. Kelas ini menyediakan fungsi untuk menampilkan teks, angka, dan nilai pada layar V5 Controller.

Objek layar screen controller tidak dibuat secara langsung.

Layar V5 Controller memiliki 3 baris dan 19 kolom untuk menampilkan teks dan angka.

Tangkapan layar dari layar Pengontrol V5, menunjukkan baris dan kolom di area yang dapat dicetak. Baris 1 Kolom 1 dimulai dari pojok kiri atas dan baris 3, kolom 19 berada di pojok kanan bawah.

Mengakses#

Kelas controller menyediakan objek Screen Objek ini merupakan instance dari kelas screen.

Obyek

Contoh Penggunaan

Keterangan

Screen

Controller.Screen.print(“Hello”);

Layar pengontrol V5.

Catatan#

  • Sebelum menggunakan fungsi anggota screen , buat objek controller.

  • Layar Controller memiliki 3 baris dan 19 kolom.

  • Posisi kursor menentukan di mana nilai yang akan dicetak selanjutnya akan muncul.

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

Fungsi Keanggotaan#

Kelas screen mencakup fungsi anggota berikut:

Tindakan — Menampilkan teks atau membersihkan layar Pengontrol.

  • print — Menampilkan teks, angka, atau nilai yang diformat pada layar Controller.

  • setCursor — Memindahkan kursor ke baris dan kolom yang ditentukan.

  • newLine — Menghapus sisa baris saat ini dan memindahkan kursor ke baris berikutnya.

  • clearScreen — Menghapus layar Pengontrol.

  • clearLine — Menghapus satu baris pada layar Controller.

Getter — Membaca posisi kursor saat ini.

  • row — Mengembalikan baris kursor saat ini.

  • column — Mengembalikan kolom kursor saat ini.

Tindakan#

print#

print menampilkan teks, angka, atau nilai yang diformat pada layar V5 Controller di posisi kursor saat ini.

Fungsi yang Tersedia

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


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

Parameter

Jenis

Keterangan

format

const char*

String format yang diberikan sebagai literal string atau string gaya C yang hanya dapat dibaca, seperti “Score: %d”.

format

char*

String format yang diberikan sebagai larik karakter yang dapat dimodifikasi.

…

Opsional. Satu atau lebih nilai tambahan dimasukkan ke dalam string format, dipisahkan oleh koma.

Nilai Kembalian

Fungsi ini tidak mengembalikan nilai.

Catatan

  • Output dimulai dari posisi kursor saat ini di layar Controller.

  • Saat menggunakan string format, jumlah dan tipe nilai yang dilewatkan harus sesuai dengan penentu format dalam string.

Contoh

// 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 memindahkan kursor ke baris dan kolom tertentu pada layar V5 Controller. Nilai yang dicetak berikutnya akan muncul di posisi tersebut.

Fungsi yang Tersedia

void setCursor(
  int32_t row,
  int32_t col
);

Parameter

Jenis

Keterangan

row

int32_t

Nomor baris tempat kursor akan ditempatkan, dari 1 hingga 3.

col

int32_t

Nomor kolom tempat kursor akan ditempatkan, dari 1 hingga 19.

Nilai Kembalian

Fungsi ini tidak mengembalikan nilai.

Contoh

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

newLine#

newLine menghapus sisa baris saat ini dan memindahkan kursor ke kolom 1 pada baris berikutnya di layar V5 Controller.

Fungsi yang Tersedia

void newLine();

Parameter

Fungsi ini tidak memiliki parameter.

Nilai Kembalian

Fungsi ini tidak mengembalikan nilai.

Contoh

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

clearScreen#

clearScreen menghapus semua teks dari layar V5 Controller.

Fungsi yang Tersedia

void clearScreen();

Parameter

Fungsi ini tidak memiliki parameter.

Nilai Kembalian

Fungsi ini tidak mengembalikan nilai.

Contoh

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

clearLine#

clearLine menghapus satu baris pada layar V5 Controller.

Fungsi yang Tersedia

void clearLine(
  int line
);


void clearLine();

Parameter

Jenis

Keterangan

line

int

Opsional. Baris yang akan dihapus, dari 1 hingga 3Jika tidak ada baris yang diberikan, baris saat ini akan dihapus.

Nilai Kembalian

Fungsi ini tidak mengembalikan nilai.

Catatan

  • Menghapus baris tidak mengubah posisi kursor saat ini.

Contoh

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

Pencari#

row#

row mengembalikan baris kursor saat ini pada layar V5 Controller.

Fungsi yang Tersedia

int32_t row();

Parameter

Fungsi ini tidak memiliki parameter.

Nilai Kembalian

Mengembalikan int32_t yang mewakili baris kursor saat ini. Penomoran baris dimulai dari 1.

Contoh

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

column#

column mengembalikan kolom kursor saat ini pada layar V5 Controller.

Fungsi yang Tersedia

int32_t column();

Parameter

Fungsi ini tidak memiliki parameter.

Nilai Kembalian

Mengembalikan int32_t yang mewakili kolom kursor saat ini. Penomoran kolom dimulai dari 1.

Contoh

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