画面#

導入#

screen クラスは controller クラスの派生クラスです。V5 コントローラ画面にテキスト、数値、値を表示するための機能を提供します。

A screen object is accessed through a controller object. It is not constructed directly.

V5コントローラーの画面は、テキストと数字を表示するための3行19列で構成されています。

V5コントローラー画面のスクリーンショット。印刷可能領域の行と列が表示されています。1行目1列目は左上隅から始まり、3行目19列目は右下隅にあります。

アクセス#

controller クラスは Screen オブジェクトを提供します。これは screen クラスのインスタンスです。

物体

使用例

説明

Screen

Controller.Screen.print(“Hello”);

V5コントローラーの画面。

注記#

  • screen メンバー関数を使用する前に、 controller オブジェクトを作成します。

  • コントローラー画面は3行19列で構成されています。

  • カーソルの位置によって、次に出力される値の位置が決まります。

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

メンバーの機能#

screen クラスには、以下のメンバ関数が含まれています。

アクション — テキストを表示するか、コントローラー画面をクリアします。

  • print — コントローラー画面に書式設定されたテキスト、数値、または値を表示します。

  • setCursor — カーソルを指定された行と列に移動します。

  • newLine — 現在の行の残りをクリアし、カーソルを次の行に移動します。

  • clearScreen — コントローラー画面をクリアします。

  • clearLine — コントローラー画面の 1 行をクリアします。

ゲッター — 現在のカーソル位置を読み取ります。

  • row — 現在のカーソル行を返します。

  • column — 現在のカーソル列を返します。

行動#

print#

print は、現在のカーソル位置に書式設定されたテキスト、数値、または値を V5 コントローラの画面に表示します。

利用可能な機能

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


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

パラメータ

タイプ

説明

format

const char*

文字列リテラルまたは読み取り専用の C スタイルの文字列として提供されるフォーマット文字列。例: “Score: %d”。

format

char*

変更可能な文字配列として提供されるフォーマット文字列。

…

オプション。書式文字列に挿入される1つ以上の追加値。カンマで区切られます。

戻り値

この関数は値を返しません。

注記

  • 出力は、コントローラー画面上の現在のカーソル位置から始まります。

  • フォーマット文字列を使用する場合、渡される値の数と型は、文字列内の フォーマット指定子 と一致する必要があります。

例

// 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 は、V5 コントローラ画面上の指定された行と列にカーソルを移動します。次に印刷される値は、その位置に表示されます。

利用可能な機能

void setCursor(
  int32_t row,
  int32_t col
);

パラメータ

タイプ

説明

row

int32_t

カーソルが配置される行番号。0 1 から 3まで。

col

int32_t

カーソルが配置される列番号。0 1 から 19まで。

戻り値

この関数は値を返しません。

例

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

newLine#

newLine 、現在の行の残りの部分をクリアし、カーソルを V5 コントローラ画面の次の行の 1 列目に移動します。

利用可能な機能

void newLine();

パラメータ

この関数には引数がありません。

戻り値

この関数は値を返しません。

例

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

clearScreen#

clearScreen 、V5 コントローラー画面からすべてのテキストを消去します。

利用可能な機能

void clearScreen();

パラメータ

この関数には引数がありません。

戻り値

この関数は値を返しません。

例

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

clearLine#

clearLine 、V5 コントローラー画面の 1 行をクリアします。

利用可能な機能

void clearLine(
  int line
);


void clearLine();

パラメータ

タイプ

説明

line

int

オプション。クリアする行 1 から 3まで）。行が指定されていない場合は、現在の行がクリアされます。

戻り値

この関数は値を返しません。

注記

  • 行をクリアしても、現在のカーソル位置は変わりません。

例

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

ゲッター#

row#

row は、V5コントローラ画面上の現在のカーソル行を返します。

利用可能な機能

int32_t row();

パラメータ

この関数には引数がありません。

戻り値

現在のカーソル行を表す int32_t を返します。行番号は 1から始まります。

例

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

column#

column 、V5コントローラ画面上の現在のカーソル列を返します。

利用可能な機能

int32_t column();

パラメータ

この関数には引数がありません。

戻り値

現在のカーソル列を表す int32_t を返します。列番号は 1から始まります。

例

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