pxt-ev3/docs/reference/brick/button/on-event.md
Peli de Halleux ea956f1a73
Buttons rename (#287)
* renaming up/down/click to released/pressed/bump

* missing images

* fixing signature issue

* updated strings

* white lego logo
2018-01-31 08:28:00 -08:00

1.5 KiB

on Event

Run some code when a button is clicked, pressed down, or released.

brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {

});

~hint

Touch sensors

Your @boardname@ has touch sensors that work like buttons. Instead of saying enter or left as the source button, use a touch sensor block with a sensor name like touch 1.

sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
    brick.setLight(BrickLight.Orange);
});

Read about touch sensors and using them as touch buttons.

~

Parameters

  • ev: the button action to run some code for. The button actions (events) are:
  • click: button was clicked (pressed and released)
  • up: button is released from just being pressed
  • down: button is just pressed down
  • body: the code you want to run when something happens with a button

Example

Check for event on the ENTER button. Put a message on the screen when the button is pressed, clicked, or released.

brick.showString("ENTER is: UP", 1);
brick.buttonEnter.onEvent(ButtonEvent.Released, function () {
    brick.showString("ENTER is: UP      ", 1);
});
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
    brick.showString("ENTER is: DOWN    ", 1);
});
brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
    brick.showString("ENTER was: CLICKED", 1);
});

See also

is pressed, was pressed,

Touch sensor