Gomb#

Bevezetés#

A button osztály a controller osztály származtatott osztálya. Hozzáférést biztosít a vezérlő gombjainak állapotaihoz és a gombesemények visszahívásaihoz.

Egy button objektumhoz egy controller objektumon keresztül lehet hozzáférni. Nem közvetlenül konstruálható.

A V5 kontroller eleje és hátulja, a gombok sárgával kiemelve. A kontroller felületén bal oldalon fel, le, balra és jobbra mutató nyílgombok találhatók, jobb oldalon pedig az X, A, B és Y gombok 12 órától az óramutató járásával megegyező irányban. A kontroller hátulján balra, jobbra az L1, L2, R1 és R2 található.

Hozzáférés#

A controller osztály a következő gomb objektumokat biztosítja. Minden objektum a button osztály egy példánya.

Objektum

Példahasználat

Leírás

ButtonA

Controller.ButtonA.pressing()

Az A gomb.

ButtonB

Controller.ButtonB.pressing()

A B gomb.

ButtonX

Controller.ButtonX.pressing()

Az X gomb.

ButtonY

Controller.ButtonY.pressing()

Az Y gomb.

ButtonDown

Controller.ButtonDown.pressing()

A Le gomb.

ButtonUp

Controller.ButtonUp.pressing()

A Fel gomb.

ButtonLeft

Controller.ButtonLeft.pressing()

A Bal gomb.

ButtonRight

Controller.ButtonRight.pressing()

A Jobbra gomb.

ButtonL1

Controller.ButtonL1.pressing()

Az L1 gomb.

ButtonL2

Controller.ButtonL2.pressing()

Az L2 gomb.

ButtonR1

Controller.ButtonR1.pressing()

Az R1 gomb.

ButtonR2

Controller.ButtonR2.pressing()

Az R2 gomb.

Megjegyzések#

  • Mielőtt button tagfüggvényt használnánk, hozzunk létre egy controller objektumot.

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

Tagfüggvények#

A button osztály a következő tagfüggvényeket tartalmazza:

Getter — Olvasás gomb állapota.

  • pressing — Visszaadja, hogy a gomb le van-e nyomva.

Visszahívások — Függvények futtatása gombesemények bekövetkeztekor.

  • pressed — Regisztrál egy függvényt, amely a gomb megnyomásakor fut.

  • released — Regisztrál egy függvényt, amely a gomb elengedésekor fut.

Getter#

préselés#

pressing megnyomása közötti különbség azt adja vissza, hogy a gomb jelenleg le van-e nyomva.

Elérhető funkció

bool pressing() const;

Paraméterek

Ennek a függvénynek nincsenek paraméterei.

Visszatérési érték

Logikai értéket ad vissza.

  • true — A gombot megnyomják.

  • false — A gombot nem nyomják meg.

Példa

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

  wait(20, msec);
}

Visszahívások#

sajtolt#

pressed egy olyan függvényt regisztrál, amely a gomb megnyomásakor fut.

Elérhető funkció

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

Paraméter

Típus

Leírás

callback

void (*)(void)

Egy függvény, amely a gomb megnyomásakor fut.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Példa

Definiáld a visszahívó függvényt main változón kívül.

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

Regisztrálja a visszahívást main változón belül.

int main() {
  vexcodeInit();

  // Run driveForward when A is pressed
  Controller.ButtonA.pressed(driveForward);
}

kiadva#

released egy olyan függvényt regisztrál, amely a gomb elengedésekor fut.

Elérhető funkció

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

Paraméter

Típus

Leírás

callback

void (*)(void)

Egy függvény, amely a gomb elengedésekor fut.

Visszatérési érték

Ez a függvény nem ad vissza értéket.

Példa

Definiáld a visszahívó függvényt main változón kívül.

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

Regisztrálja a visszahívást main változón belül.

int main() {
  vexcodeInit();

  // Run stopDriving when A is released
  Controller.ButtonA.released(stopDriving);
}