Knapp#

Introduktion#

Klassen button härleds från basklassen brain och ger åtkomst till EXP Brain-knapparna, vilket gör att din robot kan upptäcka när dess knappar trycks ner och släpps.

Tillträde#

Klassen button tillhandahåller tre button-objekt. Varje objekt är en instans av klassen button och kan nås via en brain-instans.

Objekt

Exempel på användning

Beskrivning

buttonCheck

Brain.buttonCheck.pressing()

Kontrollera-knappen

buttonLeft

Brain.buttonLeft.pressing()

Vänster knapp

buttonRight

Brain.buttonRight.pressing()

Höger knapp

Medlemsfunktioner#

Klassen button innehåller följande medlemsfunktioner:

  • pressing — Returnerar om den angivna knappen trycks ned.

  • pressed — Registrerar en funktion som ska anropas när den angivna knappen trycks ned.

  • released — Registrerar en funktion som ska anropas när den angivna knappen släpps.

Innan några button medlemsfunktioner anropas måste en brain -instans skapas, som visas nedan:

// Create the EXP Brain
brain Brain = brain();

pressing#

Returnerar om en specifik hjärnknapp trycks ned för närvarande.

Available Functions
bool pressing() const;

Parameters

Den här funktionen accepterar inga parametrar.

Return Values

Returnerar ett booleskt värde som anger om den angivna knappen trycks ned:

  • true — Knappen trycks ned.

  • false — Knappen trycks inte ned.

Examples

Den här funktionen kan anropas på vilket knappobjekt som helst, till exempel:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight
// Turn right while the check button is pressed
while (true) {
    if (Brain.buttonCheck.pressing()) {
        Drivetrain.turn(right);
    } else {
        Drivetrain.stop();
    }
    wait(5, msec);
}

pressed#

Registrerar en återuppringningsfunktion som körs när en specifik hjärnknapp trycks ned.

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

Parameters

Parameter

Typ

Beskrivning

callback

void (*)(void)

En funktion som anropas när den angivna knappen trycks ned.

Return Values

Den här funktionen returnerar inget värde.

Examples

Den här funktionen kan anropas på vilket hjärnknappobjekt som helst, till exempel:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight

Definiera callback-funktionen (utanför int main())

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

Registrera återuppringningen inuti int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Call driveForward when the right button is pressed
  Brain.buttonRight.pressed(driveForward);
}

released#

Registrerar en callback-funktion som körs när en specifik hjärnknapp släpps.

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

Parameters

Parameter

Typ

Beskrivning

callback

void (*)(void)

En funktion som anropas när den angivna knappen släpps.

Return Values

Den här funktionen returnerar inget värde.

Examples

Den här funktionen kan anropas på vilket hjärnknappobjekt som helst, till exempel:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight

Definiera callback-funktionen (utanför int main())

// Drive backward when the left button is released
void backUp() {
    Drivetrain.driveFor(reverse, 100, mm);
}

Registrera återuppringningen inuti int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Call backUp when the left button is released
  Brain.buttonLeft.released(backUp);
}