按鈕#

介紹 #

button 類別是 controller 類別的衍生類別。它提供對控制器按鈕狀態和按鈕事件回調的存取。

button 物件是透過 controller 物件存取的，它不是直接建構的。

使用權 #

controller 類別提供以下按鈕物件。每個物件都是 button 類別的一個實例。

目的	用法範例	描述
`ButtonEDown`	`Controller.ButtonEDown.pressing()`	E ▼ 按鈕。
`ButtonEUp`	`Controller.ButtonEUp.pressing()`	E ▲ 按鈕。
`ButtonFDown`	`Controller.ButtonFDown.pressing()`	F ▼ 按鈕。
`ButtonFUp`	`Controller.ButtonFUp.pressing()`	F ▲ 按鈕。
`ButtonL3`	`Controller.ButtonL3.pressing()`	左搖桿按鈕。僅適用於 IQ（第二代）控制器。
`ButtonLDown`	`Controller.ButtonLDown.pressing()`	L ▼ 按鈕。
`ButtonLUp`	`Controller.ButtonLUp.pressing()`	L ▲ 按鈕。
`ButtonR3`	`Controller.ButtonR3.pressing()`	右搖桿按鈕。僅適用於 IQ（第二代）控制器。
`ButtonRDown`	`Controller.ButtonRDown.pressing()`	R ▼ 按鈕。
`ButtonRUp`	`Controller.ButtonRUp.pressing()`	R ▲ 按鈕。

筆記 #

在使用 button 成員函數之前，請建立一個 controller 物件。
ButtonL3 和 ButtonR3 僅在 IQ（第二代）控制器上可用。

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

成員功能 #

button 類別包含以下成員函數：

Getter — 讀取按鈕狀態。

pressing — 返回按鈕是否被按下。

回調函數－當按鈕事件發生時運行的函數。

pressed — 註冊一個在按鈕被按下時運行的函數。
released — 註冊一個在按鈕釋放時運行的函數。

Getter #

pressing #

pressing 返回按鈕目前是否被按下。

可用功能

bool pressing() const;

參數

此函數沒有參數。

傳回值

返回布林值。

true — 按鈕被按下。
false — 按鈕未按下。

例子

// Turn right while R Up is pressed
while (true) {
  if (Controller.ButtonRUp.pressing()) {
    Drivetrain.turn(right);
  }
  else {
    Drivetrain.stop();
  }

  wait(20, msec);
}

回呼函數 #

pressed #

pressed 註冊一個在按鈕按下時執行的函數。

可用功能

void pressed(void (* callback)(void)) const;

範圍	類型	描述
`callback`	`void (*)(void)`	按鈕按下時運行的函數。

傳回值

此函數不傳回值。

例子

在 main之外定義回呼函數。

// Drive forward when F Up is pressed
void driveForward() {
  Drivetrain.driveFor(forward, 100, mm);
}

在 main中註冊回呼。

int main() {
  vexcodeInit();

  // Run driveForward when F Up is pressed
  Controller.ButtonFUp.pressed(driveForward);
}

released #

released 註冊一個在按鈕釋放時運行的函數。

可用功能

void released(void (* callback)(void)) const;

範圍	類型	描述
`callback`	`void (*)(void)`	按鈕釋放時運行的函數。

傳回值

此函數不傳回值。

例子

在 main之外定義回呼函數。

// Stop the drivetrain when F Up is released
void stopDriving() {
  Drivetrain.stop();
}

在 main中註冊回呼。

int main() {
  vexcodeInit();

  // Run stopDriving when F Up is released
  Controller.ButtonFUp.released(stopDriving);
}