Scherm

Invoering

De klasse screen is een afgeleide klasse van de klasse controller. Deze biedt functies voor het weergeven van tekst, getallen en waarden op het V5 Controller-scherm.

Een screen object wordt benaderd via een controller object. Het wordt niet direct geconstrueerd.

Het scherm van de V5-controller heeft 3 rijen en 19 kolommen voor het weergeven van tekst en cijfers.

Toegang

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

Voorwerp	Voorbeeldgebruik	Beschrijving
Screen	Controller.Screen.print(“Hello”);	Het scherm van de V5-controller.

Notities

• Voordat je een screen lidfunctie gebruikt, maak je een controller object aan.

• Het controllerscherm heeft 3 rijen en 19 kolommen.

• De cursorpositie bepaalt waar de volgende afgedrukte waarde verschijnt.

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

Lidfuncties

De klasse screen bevat de volgende lidfuncties:

Acties — Tekst weergeven of het controllerscherm wissen.

• print — Geeft opgemaakte tekst, getallen of waarden weer op het Controller-scherm.

• setCursor — Verplaatst de cursor naar een opgegeven rij en kolom.

• newLine — Maakt de rest van de huidige rij leeg en verplaatst de cursor naar de volgende rij.

• clearScreen — Maakt het controllerscherm leeg.

• clearLine — Maakt één rij op het Controller-scherm leeg.

Getters — Lees de huidige cursorpositie.

• row — Geeft de huidige cursorrij terug.

• column — Geeft de huidige cursorkolom terug.

Acties

print

print geeft opgemaakte tekst, getallen of waarden weer op het V5 Controller-scherm op de huidige cursorpositie.

Beschikbare functies

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

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

Parameter	Type	Beschrijving
format	const char*	Een opmaakstring die wordt aangeleverd als een tekenreeksconstante of een alleen-lezen C-stijlstring, zoals “Score: %d”.
format	char*	Een opmaakstring die wordt aangeleverd als een aanpasbare tekenreeks.
…		Optioneel. Een of meer extra waarden invoegen in de opmaakreeks, gescheiden door komma’s.

Retourwaarde

Deze functie retourneert geen waarde.

Opmerkingen

• De uitvoer begint op de huidige cursorpositie op het controllerscherm.

• Bij gebruik van een opmaakstring moeten het aantal en de typen van de doorgegeven waarden overeenkomen met de opmaakspecificaties in de string.

Voorbeeld

// 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 verplaatst de cursor naar een opgegeven rij en kolom op het V5 Controller-scherm. De volgende afgedrukte waarde verschijnt op die positie.

Beschikbare functie

void setCursor(
  int32_t row,
  int32_t col
);

Parameter	Type	Beschrijving
row	int32_t	Het rijnummer waar de cursor wordt geplaatst, van 1 tot 3.
col	int32_t	Het kolomnummer waar de cursor wordt geplaatst, van 1 tot 19.

Retourwaarde

Deze functie retourneert geen waarde.

Voorbeeld

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

newLine

newLine wist de rest van de huidige rij en verplaatst de cursor naar kolom 1 op de volgende rij van het V5 Controller-scherm.

Beschikbare functie

void newLine();

Parameters

Deze functie heeft geen parameters.

Retourwaarde

Deze functie retourneert geen waarde.

Voorbeeld

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

clearScreen

clearScreen wist alle tekst van het V5 Controller-scherm.

Beschikbare functie

void clearScreen();

Parameters

Deze functie heeft geen parameters.

Retourwaarde

Deze functie retourneert geen waarde.

Voorbeeld

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

clearLine

clearLine wist één rij op het V5 Controller-scherm.

Beschikbare functies

void clearLine(
  int line
);

void clearLine();

Parameter	Type	Beschrijving
line	int	Optioneel. De rij die gewist moet worden, van 1 tot 3Als er geen rij wordt opgegeven, wordt de huidige rij gewist.

Retourwaarde

Deze functie retourneert geen waarde.

Opmerkingen

• Het wissen van een rij verandert de huidige cursorpositie niet.

Voorbeeld

// 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 geeft de huidige cursorrij op het V5 Controller-scherm weer.

Beschikbare functie

int32_t row();

Parameters

Deze functie heeft geen parameters.

Retourwaarde

Retourneert een int32_t die de huidige cursorrij vertegenwoordigt. De rijnummering begint bij 1.

Voorbeeld

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

column

column geeft de huidige cursorkolom op het V5 Controller-scherm weer.

Beschikbare functie

int32_t column();

Parameters

Deze functie heeft geen parameters.

Retourwaarde

Retourneert een int32_t die de huidige cursor-kolom vertegenwoordigt. De kolomnummering begint bij 1.

Voorbeeld

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