Botón#

Introducción#

The button class is derived from the brain base class and provides access to the IQ (2nd gen) Brain’s buttons, allowing your robot to monitor presses to the brain’s buttons.

Acceso#

The brain class provides twelve button objects. Each object is an instance of the button class and can be accessed through a brain instance.

Objeto

Ejemplo de uso

Descripción

buttonCheck

Brain.buttonCheck.pressing()

Botón de verificación

buttonLeft

Brain.buttonLeft.pressing()

Botón izquierdo

buttonRight

Brain.buttonRight.pressing()

Botón derecho

Notas#

  • The button object is provided by the brain. It is not constructed directly.

Funciones de los miembros#

The Button class includes the following member functions:

  • pressed — Registers a function to be called when the specified button is pressed.

  • released — Registers a function to be called when the specified button is released.

  • pressing — Returns whether the specified button is being pressed.

Before calling any button member functions, a brain instance must be created, as shown below:

// Create a brain instance
brain();

apretado#

Registra una función de devolución de llamada que se ejecuta cuando se presiona un botón cerebral específico.

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

Parameters

Parámetro

Tipo

Descripción

callback

void (*)(void)

Una función que se llama cuando se presiona el botón especificado.

Return Values

Esta función no devuelve ningún valor.

Examples

Esta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:

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

Define the callback function (outside of int main())

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

Register the callback inside int main()

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

  // Call driveForward when the check button is pressed
  Brain.buttonCheck.pressed(driveForward);
}

liberado#

Registra una función de devolución de llamada que se ejecuta cuando se suelta un botón cerebral específico.

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

Parámetros#

Parámetro

Tipo

Descripción

callback

void (*)(void)

Una función que se llama cuando se suelta el botón especificado.

Return Values

Esta función no devuelve ningún valor.

Examples

Esta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:

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

Define the callback function (outside of int main())

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

Register the callback inside 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);
}

prensado#

Indica si se está presionando un botón cerebral específico en ese momento.

Available Functions
bool pressing() const;

Parameters

Esta función no acepta ningún parámetro.

Return Values

Devuelve un valor booleano que indica si se está pulsando el botón especificado:

  • true — The button is being pressed.

  • false — The button is not being pressed.

Examples

Esta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:

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