Ekran#

giriiş#

screen sınıfı, controller sınıfının türetilmiş bir sınıfıdır. V5 Denetleyici ekranında metin, sayı ve değerleri görüntülemek için işlevler sağlar.

Bir screen nesnesine, bir controller nesnesi aracılığıyla erişilir. Doğrudan oluşturulmaz.

V5 Kontrol Cihazı ekranı, metin ve sayıları görüntülemek için 3 satır ve 19 sütuna sahiptir.

Yazdırılabilir alandaki satır ve sütunları gösteren V5 Kontrol Cihazı ekranının bir ekran görüntüsü. 1. Satır 1. Sütun sol üst köşeden başlar ve 3. Satır 19. Sütun sağ alt köşededir.

Erişim#

controller sınıfı, Screen nesnesi sağlar. Bu, screen sınıfının bir örneğidir.

Nesne

Örnek Kullanım

Tanım

Screen

Controller.Screen.print(“Hello”);

V5 Kontrol Cihazı ekranı.

Notlar#

  • screen üye fonksiyonunu kullanmadan önce, controller nesnesi oluşturun.

  • Kontrol paneli ekranı 3 satır ve 19 sütundan oluşmaktadır.

  • İmlecin konumu, bir sonraki yazdırılan değerin nerede görüneceğini belirler.

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

Üye Fonksiyonları#

screen sınıfı aşağıdaki üye fonksiyonlarını içerir:

İşlemler — Metni görüntüle veya Kontrol Ekranını temizle.

  • print — Denetleyici ekranında biçimlendirilmiş metin, sayılar veya değerler görüntüler.

  • setCursor — İmleci belirtilen satır ve sütuna taşır.

  • newLine — Geçerli satırın geri kalanını temizler ve imleci bir sonraki satıra taşır.

  • clearScreen — Kontrolör ekranını temizler.

  • clearLine — Kontrolör ekranındaki bir satırı temizler.

Getter’lar — Mevcut imleç konumunu okur.

  • row — Geçerli imleç satırını döndürür.

  • column — Geçerli imleç sütununu döndürür.

Eylemler#

print#

print komutu, biçimlendirilmiş metni, sayıları veya değerleri V5 Kontrol Cihazı ekranında mevcut imleç konumunda görüntüler.

Mevcut Fonksiyonlar

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


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

Parametre

Tip

Tanım

format

const char*

Bir dize değişmezi veya salt okunur C stili dize olarak sağlanan bir biçim dizesi, örneğin “Score: %d”.

format

char*

Değiştirilebilir bir karakter dizisi olarak sağlanan bir biçim dizesi.

…

İsteğe bağlı. Biçim dizesine virgülle ayrılmış bir veya daha fazla ek değer eklenebilir.

Dönüş Değeri

Bu fonksiyon bir değer döndürmez.

Notlar

  • Çıktı, Kontrolör ekranındaki mevcut imleç konumundan başlar.

  • Biçim dizesi kullanılırken, geçirilen değerlerin sayısı ve türleri, dizedeki biçim belirleyicilerle eşleşmelidir.

Örnek

// 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 komutu, imleci V5 Kontrol Cihazı ekranında belirtilen satır ve sütuna taşır. Bir sonraki yazdırılan değer o konumda görünecektir.

Mevcut Fonksiyon

void setCursor(
  int32_t row,
  int32_t col
);

Parametre

Tip

Tanım

row

int32_t

İmlecin yerleştirileceği satır numarası, 1 ile 3 arasındadır.

col

int32_t

İmlecin yerleştirileceği sütun numarası, 1 ile 19 arasındadır.

Dönüş Değeri

Bu fonksiyon bir değer döndürmez.

Örnek

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

newLine#

newLine komutu, geçerli satırın geri kalanını temizler ve imleci V5 Kontrol Cihazı ekranının bir sonraki satırındaki 1. sütuna taşır.

Mevcut Fonksiyon

void newLine();

Parametreler

Bu fonksiyonun parametresi yoktur.

Dönüş Değeri

Bu fonksiyon bir değer döndürmez.

Örnek

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

clearScreen#

clearScreen komutu, V5 Kontrol Cihazı ekranındaki tüm metni siler.

Mevcut Fonksiyon

void clearScreen();

Parametreler

Bu fonksiyonun parametresi yoktur.

Dönüş Değeri

Bu fonksiyon bir değer döndürmez.

Örnek

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

clearLine#

clearLine komutu, V5 Kontrol Cihazı ekranında bir satırı temizler.

Mevcut Fonksiyonlar

void clearLine(
  int line
);


void clearLine();

Parametre

Tip

Tanım

line

int

İsteğe bağlı. Temizlenecek satır, 1 ile 3arasında. Satır belirtilmezse, geçerli satır temizlenir.

Dönüş Değeri

Bu fonksiyon bir değer döndürmez.

Notlar

  • Bir satırı temizlemek, mevcut imleç konumunu değiştirmez.

Örnek

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

Getters#

row#

row V5 Kontrol Cihazı ekranında imlecin bulunduğu geçerli satırı döndürür.

Mevcut Fonksiyon

int32_t row();

Parametreler

Bu fonksiyonun parametresi yoktur.

Dönüş Değeri

Geçerli imleç satırını temsil eden int32_t değerini döndürür. Satır numaralandırması 1 başlar.

Örnek

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

column#

column V5 Kontrol Cihazı ekranındaki geçerli imleç sütununu döndürür.

Mevcut Fonksiyon

int32_t column();

Parametreler

Bu fonksiyonun parametresi yoktur.

Dönüş Değeri

Geçerli imleç sütununu temsil eden int32_t değerini döndürür. Sütun numaralandırması 1 başlar.

Örnek

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