Skärm#

Introduktion#

Klassen screen är en härledd klass av klassen controller. Den tillhandahåller funktioner för att visa text, siffror och värden på V5-controllerskärmen.

Ett screen objekt nås via ett controller objekt. Det är inte konstruerat direkt.

V5-kontrollens skärm har 3 rader och 19 kolumner för visning av text och siffror.

En skärmdump av V5-styrenhetens skärm som visar raderna och kolumnerna i det utskrivbara området. Rad 1 Kolumn 1 börjar i det övre vänstra hörnet och rad 3, kolumn 19 finns i det nedre högra hörnet.

Tillträde#

controller tillhandahåller ett Screen objekt. Det är en instans av screen -klassen.

Objekt

Exempel på användning

Beskrivning

Screen

Controller.Screen.print(“Hello”);

V5-kontrollskärmen.

Anteckningar#

  • Innan du använder en screen medlemsfunktion, skapa ett controller objekt.

  • Kontrollskärmen har 3 rader och 19 kolumner.

  • Markörens position avgör var nästa utskrivna värde visas.

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

Medlemsfunktioner#

Klassen screen innehåller följande medlemsfunktioner:

Åtgärder — Visa text eller rensa kontrollskärmen.

  • print — Visar formaterad text, siffror eller värden på kontrollenhetens skärm.

  • setCursor — Flyttar markören till en angiven rad och kolumn.

  • newLine — Rensar resten av den aktuella raden och flyttar markören till nästa rad.

  • clearScreen — Rensar kontrollskärmen.

  • clearLine — Rensar en rad på kontrollskärmen.

Getters — Läser den aktuella markörpositionen.

  • row — Returnerar den aktuella markörraden.

  • column — Returnerar den aktuella markörkolumnen.

Åtgärder#

print#

print visar formaterad text, siffror eller värden på V5-kontrollenhetens skärm vid markörens aktuella position.

Tillgängliga funktioner

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


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

Parameter

Typ

Beskrivning

format

const char*

En formatsträng som tillhandahålls som en stränglitteral eller skrivskyddad C-sträng, till exempel “Score: %d”.

format

char*

En formatsträng som tillhandahålls som en modifierbar teckenmatris.

…

Valfritt. Ett eller flera ytterligare värden infogas i formatsträngen, separerade med kommatecken.

Returvärde

Den här funktionen returnerar inget värde.

Anteckningar

  • Utmatningen börjar vid den aktuella markörpositionen på kontrollskärmen.

  • När en formatsträng används måste antalet och typerna av värden som skickas matcha formatspecificerare i strängen.

Exempel

// 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 flyttar markören till en angiven rad och kolumn på V5-styrenhetens skärm. Nästa utskrivna värde visas på den positionen.

Tillgänglig funktion

void setCursor(
  int32_t row,
  int32_t col
);

Parameter

Typ

Beskrivning

row

int32_t

Radnumret där markören ska placeras, från 1 till 3.

col

int32_t

Kolumnnumret där markören ska placeras, från 1 till 19.

Returvärde

Den här funktionen returnerar inget värde.

Exempel

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

newLine#

newLine rensar resten av den aktuella raden och flyttar markören till kolumn 1 på nästa rad på V5-styrenhetens skärm.

Tillgänglig funktion

void newLine();

Parametrar

Den här funktionen har inga parametrar.

Returvärde

Den här funktionen returnerar inget värde.

Exempel

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

clearScreen#

clearScreen rensar all text från V5-styrenhetens skärm.

Tillgänglig funktion

void clearScreen();

Parametrar

Den här funktionen har inga parametrar.

Returvärde

Den här funktionen returnerar inget värde.

Exempel

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

clearLine#

clearLine rensar en rad på V5-styrenhetens skärm.

Tillgängliga funktioner

void clearLine(
  int line
);


void clearLine();

Parameter

Typ

Beskrivning

line

int

Valfritt. Raden som ska rensas, från 1 till 3Om ingen rad anges rensas den aktuella raden.

Returvärde

Den här funktionen returnerar inget värde.

Anteckningar

  • Att rensa en rad ändrar inte markörens aktuella position.

Exempel

// 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 returnerar den aktuella markörraden på V5-styrenhetens skärm.

Tillgänglig funktion

int32_t row();

Parametrar

Den här funktionen har inga parametrar.

Returvärde

Returnerar int32_t som representerar den aktuella markörraden. Radnumreringen börjar vid 1.

Exempel

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

column#

column returnerar den aktuella markörkolumnen på V5-styrenhetens skärm.

Tillgänglig funktion

int32_t column();

Parametrar

Den här funktionen har inga parametrar.

Returvärde

Returnerar int32_t som representerar den aktuella markörkolumnen. Kolumnnumreringen börjar vid 1.

Exempel

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