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 |
|---|---|---|
|
|
Botón de verificación |
|
|
Botón izquierdo |
|
|
Botón derecho |
Notas#
The
buttonobject 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 Functionsvoid pressed(
void (* callback)(void) ) const;
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
|
Una función que se llama cuando se presiona el botón especificado. |
Esta función no devuelve ningún valor.
ExamplesEsta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:
Brain.buttonCheckBrain.buttonLeftBrain.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 Functionsvoid released(
void (* callback)(void) ) const;
Parámetros#
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
|
Una función que se llama cuando se suelta el botón especificado. |
Esta función no devuelve ningún valor.
ExamplesEsta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:
Brain.buttonCheckBrain.buttonLeftBrain.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 Functionsbool pressing() const;
Esta función no acepta ningún parámetro.
Return ValuesDevuelve 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.
Esta función se puede llamar en cualquier objeto de botón cerebral, por ejemplo:
Brain.buttonCheckBrain.buttonLeftBrain.buttonRight
// Turn right while right is pressed
while (true) {
if (Brain.buttonRight.pressing()) {
Drivetrain.turn(right);
} else {
Drivetrain.stop();
}
wait(5, msec);
}