Bildschirm

Einführung

The screen class is a derived class of the controller class. It provides functions for displaying text, numbers, and values on the V5 Controller screen.

Auf ein Objekt screen wird über ein Objekt vom Typ controller zugegriffen. Es wird nicht direkt erstellt.

Der Bildschirm des V5-Controllers verfügt über 3 Zeilen und 19 Spalten zur Anzeige von Text und Zahlen.

Zugang

The controller class provides a Screen object. It is an instance of the screen class.

Objekt	Anwendungsbeispiel	Beschreibung
Screen	Controller.Screen.print(“Hello”);	Der V5-Controller-Bildschirm.

Anmerkungen

• Bevor Sie eine Memberfunktion vom screen verwenden, erstellen Sie ein Controllerobjekt controller.

• Der Controller-Bildschirm hat 3 Zeilen und 19 Spalten.

• Die Cursorposition bestimmt, wo der nächste ausgegebene Wert erscheint.

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

Mitgliedsfunktionen

Die Klasse screen umfasst die folgenden Memberfunktionen:

Aktionen – Text anzeigen oder Controller-Bildschirm löschen.

• print — Zeigt formatierten Text, Zahlen oder Werte auf dem Controller-Bildschirm an.

• setCursor — Verschiebt den Cursor in eine angegebene Zeile und Spalte.

• newLine — Löscht den Rest der aktuellen Zeile und bewegt den Cursor zur nächsten Zeile.

• clearScreen — Löscht den Controller-Bildschirm.

• clearLine — Löscht eine Zeile auf dem Controller-Bildschirm.

Getter – Lesen Sie die aktuelle Cursorposition.

• row — Gibt die aktuelle Cursorzeile zurück.

• column — Gibt die aktuelle Cursorspalte zurück.

Aktionen

print

print zeigt formatierten Text, Zahlen oder Werte auf dem V5 Controller-Bildschirm an der aktuellen Cursorposition an.

Verfügbare Funktionen

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

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

Parameter	Typ	Beschreibung
format	const char*	Eine Formatzeichenkette, die als Zeichenkettenliteral oder schreibgeschützte Zeichenkette im C-Stil angegeben wird, z. B. “Score: %d”.
format	char*	Eine Formatzeichenkette, die als veränderbares Zeichenarray bereitgestellt wird.
…		Optional. Ein oder mehrere zusätzliche Werte, die durch Kommas getrennt in die Formatzeichenfolge eingefügt werden.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

• Die Ausgabe beginnt an der aktuellen Cursorposition auf dem Controller-Bildschirm.

• Bei Verwendung einer Formatzeichenfolge müssen die Anzahl und die Typen der übergebenen Werte mit den Formatbezeichnern in der Zeichenfolge übereinstimmen.

Beispiel

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

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

setCursor

Mit dem Befehl setCursor wird der Cursor auf die angegebene Zeile und Spalte des V5-Controller-Bildschirms gesetzt. Der nächste ausgegebene Wert erscheint an dieser Position.

Verfügbare Funktionen

void setCursor(
  int32_t row,
  int32_t col
);

Parameter	Typ	Beschreibung
row	int32_t	Die Zeilennummer, an der der Cursor platziert werden soll, von 1 bis 3.
col	int32_t	Die Spaltennummer, an der der Cursor platziert werden soll, von 1 bis 19.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

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

newLine

newLine löscht den Rest der aktuellen Zeile und bewegt den Cursor in Spalte 1 der nächsten Zeile des V5-Controller-Bildschirms.

Verfügbare Funktionen

void newLine();

Parameter

Diese Funktion hat keine Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

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

clearScreen

clearScreen löscht den gesamten Text vom Bildschirm des V5-Controllers.

Verfügbare Funktionen

void clearScreen();

Parameter

Diese Funktion hat keine Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

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

clearLine

clearLine löscht eine Zeile auf dem V5-Controller-Bildschirm.

Verfügbare Funktionen

void clearLine(
  int line
);

void clearLine();

Parameter	Typ	Beschreibung
line	int	Optional. Die zu löschende Zeile ( 1 bis 3. Wird keine Zeile angegeben, wird die aktuelle Zeile gelöscht.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

• Das Löschen einer Zeile ändert die aktuelle Cursorposition nicht.

Beispiel

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

Getter

row

row gibt die aktuelle Cursorzeile auf dem V5-Controller-Bildschirm zurück.

Verfügbare Funktionen

int32_t row();

Parameter

Diese Funktion hat keine Parameter.

Rückgabewert

Gibt einen int32_t zurück, der die aktuelle Cursorzeile repräsentiert. Die Zeilennummerierung beginnt bei 1.

Beispiel

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

column

column gibt die aktuelle Cursorspalte auf dem V5-Controller-Bildschirm zurück.

Verfügbare Funktionen

int32_t column();

Parameter

Diese Funktion hat keine Parameter.

Rückgabewert

Gibt einen int32_t zurück, der die aktuelle Cursorspalte darstellt. Die Spaltennummerierung beginnt bei 1.

Beispiel

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