Κουμπί#

Εισαγωγή #

Η κλάση button είναι μια παράγωγη κλάση της κλάσης controller. Παρέχει πρόσβαση στις καταστάσεις των κουμπιών του ελεγκτή και στις ανακλήσεις συμβάντων κουμπιών.

Ένα αντικείμενο button είναι προσβάσιμο μέσω ενός αντικειμένου controller Δεν κατασκευάζεται απευθείας.

Το χειριστήριο IQ (1ης γενιάς) έχει οκτώ κύρια κουμπιά. Εάν ένα χειριστήριο IQ (2ης γενιάς) είναι συνδεδεμένο στο IQ (1ης γενιάς) Brain, μπορούν επίσης να χρησιμοποιηθούν τα κουμπιά joystick ButtonL3 και ButtonR3.

Πρόσβαση #

The controller class provides the following button objects. Each object is an instance of the button class.

Αντικείμενο	Παράδειγμα Χρήσης	Περιγραφή
`ButtonEDown`	`Controller.ButtonEDown.pressing()`	Το κουμπί E ▼.
`ButtonEUp`	`Controller.ButtonEUp.pressing()`	Το κουμπί E ▲.
`ButtonFDown`	`Controller.ButtonFDown.pressing()`	Το κουμπί F ▼.
`ButtonFUp`	`Controller.ButtonFUp.pressing()`	Το κουμπί F ▲.
`ButtonLDown`	`Controller.ButtonLDown.pressing()`	Το κουμπί L ▼.
`ButtonLUp`	`Controller.ButtonLUp.pressing()`	Το κουμπί L ▲.
`ButtonRDown`	`Controller.ButtonRDown.pressing()`	Το κουμπί R ▼.
`ButtonRUp`	`Controller.ButtonRUp.pressing()`	Το κουμπί R ▲.
`ButtonL3`	`Controller.ButtonL3.pressing()`	Το κουμπί Αριστερό Joystick. Μόνο για το χειριστήριο IQ (2ης γενιάς).
`ButtonR3`	`Controller.ButtonR3.pressing()`	Το κουμπί του Δεξιού Joystick. Μόνο για το χειριστήριο IQ (2ης γενιάς).

Σημειώσεις #

Πριν χρησιμοποιήσετε μια συνάρτηση μέλους button , δημιουργήστε ένα αντικείμενο controller.
ButtonL3 και ButtonR3 είναι διαθέσιμα μόνο όταν είναι συνδεδεμένος ένας ελεγκτής IQ (2ης γενιάς).

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

Συναρτήσεις Μελών #

Η κλάση button περιλαμβάνει τις ακόλουθες συναρτήσεις-μέλη:

Getter — Ανάγνωση κατάστασης κουμπιού.

pressing — Επιστρέφει εάν το κουμπί είναι πατημένο.

Επιστροφές κλήσεων — Εκτέλεση συναρτήσεων όταν προκύπτουν συμβάντα κουμπιών.

pressed — Καταχωρεί μια λειτουργία που θα εκτελεστεί όταν πατηθεί το κουμπί.
released — Καταχωρεί μια συνάρτηση που θα εκτελεστεί όταν αφήσετε το κουμπί.

Λήπτης #

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);
}