918af4f3ac
* 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>
55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
# On Button Pressed
|
|
|
|
Start an [event handler](/reference/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.
|
|
|
|
```sig
|
|
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](/device/screen) shows the `count` variable getting bigger.
|
|
|
|
```blocks
|
|
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.
|
|
|
|
```blocks
|
|
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](/reference/input/button-is-pressed), [forever](/reference/basic/forever), [random](/blocks/math)
|
|
|