pxt-calliope/docs/reference/input/on-button-pressed.md
Amerlander 918af4f3ac
Bump V3.0.22 (#110)
* change simulator svg

* change radio image

* Remove google fonts cdn

* change color of 'advanced' button

* font fix

* font fix 2

* display fix

* change fullsceen simulator bg

* Continuous servo

* handle continuous state

* adding shims

* update rendering for continuous servos

* fixing sim

* fix sig

* typo

* fix sim

* bump pxt

* bump pxt

* rerun travis

* Input blocks revision

- add Button and Pin event types
- merge onPinPressed & onPinReleased in new onPinEvent function
- create new onButtonEvent function

* update input blocks in docs and tests

* remove device_pin_release block

* Hide DAL.x behind Enum

* bring back deprecated blocks, but hide them

* shims and locales files

* fix input.input. typing

* remove buildpr

* bump V3

* update simulator aspect ratio

* add Loudness Block

* revoke loudness block

* Adds soundLevel

To be replaced by pxt-common-packages when DAL is updated.

* Remove P0 & P3 from AnalogPin

Co-authored-by: Juri <gitkraken@juriwolf.de>
2020-09-08 02:04:25 -07:00

1.6 KiB

On Button Pressed

Start an event handler (part of the program that will run when something happens, like when a button is pressed). This handler works when button A or B is pressed, or A and B together. When you are using this function in a web browser, click the buttons on the screen instead of the ones on the @boardname@.

  • For button A or B: This handler works when the button is pushed down and released within 1 second.
  • For A and B together: This handler works when A and B are both pushed down, then one of them is released within 1.5 seconds of pushing down the second button.
input.onButtonPressed(Button.A, () => {})

Find out how buttons provide input to the @boardname@ in this video:

https://www.youtube.com/watch?v=t_Qujjd_38o

Example: count button clicks

This example counts how many times you press the A button. Each time you press the button, the LED screen shows the count variable getting bigger.

let count = 0
basic.showNumber(count)
input.onButtonPressed(Button.A, () => {
    count++;
    basic.showNumber(count);
})

Example: roll dice

This example shows a number from 1 to 6 when you press the B button.

input.onButtonPressed(Button.B, () => {
    let dice = randint(0, 5) + 1
    basic.showNumber(dice)
})

~hint

This program adds a 1 to random(5) so the numbers on the dice will come out right. Otherwise, sometimes they would show a 0.

~

See also

button is pressed, forever, random