1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
|
Buttons
*******
.. py::module:: microbit
There are two buttons on the board, called ``button_a`` and ``button_b``.
Attributes
==========
.. py:attribute:: button_a
A ``Button`` instance (see below) representing the left button.
.. py:attribute:: button_b
Represents the right button.
Classes
=======
.. py:class:: Button()
Represents a button.
.. note::
This class is not actually available to the user, it is only used by
the two button instances, which are provided already initialized.
.. py:method:: is_pressed()
Returns ``True`` if the specified button ``button`` is currently being
held down, and ``False`` otherwise.
.. py:method:: was_pressed()
Returns ``True`` or ``False`` to indicate if the button was pressed
(went from up to down) since the device started or the last time this
method was called. Calling this method will clear the press state so
that the button must be pressed again before this method will return
``True`` again.
.. py:method:: get_presses()
Returns the running total of button presses, and resets this total
to zero before returning.
Example
=======
.. code::
import microbit
while True:
if microbit.button_a.is_pressed() and microbit.button_b.is_pressed():
microbit.display.scroll("AB")
break
elif microbit.button_a.is_pressed():
microbit.display.scroll("A")
elif microbit.button_b.is_pressed():
microbit.display.scroll("B")
microbit.sleep(100)
|