Écran

Introduction

La classe screen est une classe dérivée de la classe controller. Elle fournit des fonctions pour afficher du texte, des nombres et des valeurs sur l’écran du contrôleur V5.

Un objet écran screen est accessible via un objet contrôleur controller . Il n’est pas construit directement.

L’écran du contrôleur V5 comporte 3 lignes et 19 colonnes pour l’affichage de texte et de chiffres.

Accéder

La classe controller fournit un objet Screen Il s’agit d’une instance de la classe screen.

Objet	Exemple d’utilisation	Description
Screen	Controller.Screen.print(“Hello”);	L’écran du contrôleur V5.

Notes

• Avant d’utiliser une fonction membre screen , créez un objet controller.

• L’écran du contrôleur comporte 3 lignes et 19 colonnes.

• La position du curseur détermine l’emplacement de la prochaine valeur imprimée.

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

Fonctions des membres

La classe screen comprend les fonctions membres suivantes :

Actions — Afficher du texte ou effacer l’écran du contrôleur.

• print — Affiche du texte formaté, des nombres ou des valeurs sur l’écran du contrôleur.

• setCursor — Déplace le curseur vers une ligne et une colonne spécifiées.

• newLine — Efface le reste de la ligne actuelle et déplace le curseur vers la ligne suivante.

• clearScreen — Efface l’écran du contrôleur.

• clearLine — Efface une ligne sur l’écran du contrôleur.

Getters — Lire la position actuelle du curseur.

• row — Renvoie la ligne actuelle du curseur.

• column — Renvoie la colonne du curseur actuel.

Actes

print

print affiche du texte formaté, des nombres ou des valeurs sur l’écran du contrôleur V5 à la position actuelle du curseur.

Fonctions disponibles

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

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

Paramètre	Taper	Description
format	const char*	Une chaîne de format fournie sous forme de chaîne littérale ou de chaîne de style C en lecture seule, telle que “Score: %d”.
format	char*	Une chaîne de format fournie sous forme de tableau de caractères modifiable.
…		Facultatif. Une ou plusieurs valeurs supplémentaires peuvent être insérées dans la chaîne de format, séparées par des virgules.

Valeur de retour

Cette fonction ne renvoie aucune valeur.

Remarques

• L’affichage commence à la position actuelle du curseur sur l’écran du contrôleur.

• Lors de l’utilisation d’une chaîne de format, le nombre et les types de valeurs transmises doivent correspondre aux spécificateurs de format dans la chaîne.

Exemple

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

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

setCursor

La commande setCursor déplace le curseur vers une ligne et une colonne spécifiées sur l’écran du contrôleur V5. La prochaine valeur imprimée apparaîtra à cet emplacement.

Fonction disponible

void setCursor(
  int32_t row,
  int32_t col
);

Paramètre	Taper	Description
row	int32_t	Le numéro de ligne où le curseur sera placé, de 1 à 3.
col	int32_t	Le numéro de colonne où le curseur sera placé, de 1 à 19.

Valeur de retour

Cette fonction ne renvoie aucune valeur.

Exemple

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

newLine

La commande newLine efface le reste de la ligne actuelle et déplace le curseur vers la colonne 1 de la ligne suivante de l’écran du contrôleur V5.

Fonction disponible

void newLine();

Paramètres

Cette fonction ne possède pas de paramètres.

Valeur de retour

Cette fonction ne renvoie aucune valeur.

Exemple

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

clearScreen

clearScreen efface tout le texte de l’écran du contrôleur V5.

Fonction disponible

void clearScreen();

Paramètres

Cette fonction ne possède pas de paramètres.

Valeur de retour

Cette fonction ne renvoie aucune valeur.

Exemple

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

clearLine

clearLine efface une ligne sur l’écran du contrôleur V5.

Fonctions disponibles

void clearLine(
  int line
);

void clearLine();

Paramètre	Taper	Description
line	int	Facultatif. La ligne à effacer, de 1 à 3Si aucune ligne n’est fournie, la ligne courante est effacée.

Valeur de retour

Cette fonction ne renvoie aucune valeur.

Remarques

• Effacer une ligne ne modifie pas la position actuelle du curseur.

Exemple

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

La ligne row renvoie la ligne actuelle du curseur sur l’écran du contrôleur V5.

Fonction disponible

int32_t row();

Paramètres

Cette fonction ne possède pas de paramètres.

Valeur de retour

Renvoie un int32_t int32_t représentant la ligne actuelle du curseur. La numérotation des lignes commence à 1.

Exemple

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

column

La colonne column renvoie la colonne actuelle du curseur sur l’écran du contrôleur V5.

Fonction disponible

int32_t column();

Paramètres

Cette fonction ne possède pas de paramètres.

Valeur de retour

Renvoie un int32_t int32_t représentant la colonne actuelle du curseur. La numérotation des colonnes commence à 1.

Exemple

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