Cnaipe#

Réamhrá#

Is rang díorthaithe den rang button an rang cnaipe controller Soláthraíonn sé rochtain ar stáit cnaipe an Rialaitheora agus ar aisghlaoite imeachtaí cnaipe.

Is féidir rochtain a fháil ar réad button trí réad controller Ní thógtar go díreach é.

Rochtain#

Soláthraíonn an rang rialaitheora controller na réada cnaipe seo a leanas. Is sampla den rang cnaipe button gach réad.

Réad	Úsáid Shamplach	Cur síos
`ButtonA`	`Controller.ButtonA.pressing()`	An cnaipe A.
`ButtonB`	`Controller.ButtonB.pressing()`	An cnaipe B.
`ButtonX`	`Controller.ButtonX.pressing()`	An cnaipe X.
`ButtonY`	`Controller.ButtonY.pressing()`	An cnaipe Y.
`ButtonDown`	`Controller.ButtonDown.pressing()`	An cnaipe Síos.
`ButtonUp`	`Controller.ButtonUp.pressing()`	An cnaipe Suas.
`ButtonLeft`	`Controller.ButtonLeft.pressing()`	An cnaipe Ar Chlé.
`ButtonRight`	`Controller.ButtonRight.pressing()`	An cnaipe Ar Dheis.
`ButtonL1`	`Controller.ButtonL1.pressing()`	An cnaipe L1.
`ButtonL2`	`Controller.ButtonL2.pressing()`	An cnaipe L2.
`ButtonR1`	`Controller.ButtonR1.pressing()`	An cnaipe R1.
`ButtonR2`	`Controller.ButtonR2.pressing()`	An cnaipe R2.

Nótaí#

Sula n-úsáideann tú feidhm cnaipe button bhall, cruthaigh réad controller.

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

Feidhmeanna na mBall#

Áirítear leis an rang cnaipe button na feidhmeanna ball seo a leanas:

Getter — Léigh staid an chnaipe.

pressing — Tugann sé seo le fios an bhfuil an cnaipe á bhrú.

Glaonna ar ais — Feidhmeanna a rith nuair a tharlaíonn imeachtaí cnaipe.

pressed — Cláraíonn sé feidhm le rith nuair a bhrúitear an cnaipe.
released — Cláraíonn sé feidhm le rith nuair a scaoiltear an cnaipe.

Faighteoir#

ag brú#

Má bhrúnn tú pressing , tugann sé sin ar ais an bhfuil an cnaipe á bhrú faoi láthair.

Feidhm atá ar Fáil

bool pressing() const;

Paraiméadair

Níl paraiméadair ag an bhfeidhm seo.

Luach Tuairisceáin

Tugann sé luach Booleánach ar ais.

true — Tá an cnaipe á bhrú.
false — Níl an cnaipe á bhrú.

Sampla

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

  wait(20, msec);
}

Glaonna ar ais#

brúite#

pressed feidhm a ritheann nuair a bhrúitear an cnaipe.

Feidhm atá ar Fáil

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

Paraiméadar	Cineál	Cur síos
`callback`	`void (*)(void)`	Feidhm a ritheann nuair a bhrúitear an cnaipe.

Luach Tuairisceáin

Ní thugann an fheidhm seo luach ar ais.

Sampla

Sainmhínigh an fheidhm athghlaoite lasmuigh de main.

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

Cláraigh an glao ar ais taobh istigh de main.

int main() {
  vexcodeInit();

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

scaoilte#

released feidhm a ritheann nuair a scaoiltear an cnaipe.

Feidhm atá ar Fáil

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

Paraiméadar	Cineál	Cur síos
`callback`	`void (*)(void)`	Feidhm a ritheann nuair a scaoiltear an cnaipe.

Luach Tuairisceáin

Ní thugann an fheidhm seo luach ar ais.

Sampla

Sainmhínigh an fheidhm athghlaoite lasmuigh de main.

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

Cláraigh an glao ar ais taobh istigh de main.

int main() {
  vexcodeInit();

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