Core Button class.
More...
#include <Button.h>
|
static uint8_t | nextId () |
| Return the next auto-assigned button identifier. More...
|
|
template<typename
Circuit, typename
Pin>
class able::Button< Circuit, Pin >
Core Button class.
It supports pulldown and pull-up resistor circuits specified using the Circuit template parameter and different pin features using the Pin template parameter.
- Parameters
-
Definition at line 22 of file Button.h.
◆ Button()
Create a button on the specified pin.
- Parameters
-
pin | The pin connected to the button. |
Definition at line 33 of file Button.h.
◆ begin()
Initialise the button.
Called from setup() of an Arduino program.
Definition at line 51 of file Button.h.
◆ handle()
Handle the button.
Called from loop() of an Arduino program.
Definition at line 58 of file Button.h.
◆ isClicked()
Determine if the button is clicked.
Clicks are registered as a press then release. If the ClickerPin (or subclass) is used, the button returns the click state, otherwise the compile will fail with errors.
- Returns
- True if clicked else false.
Definition at line 132 of file Button.h.
◆ isDoubleClicked()
Determine if the button is double-clicked.
Double-clicks are registered as two clicks within the double-click time. If the DoubleClickPin is used, the button returns the double-click state, otherwise the compile will fail with errors.
- Returns
- True if double-clicked else false.
Definition at line 144 of file Button.h.
◆ isHeld()
Determine if the button is currently held down.
- Returns
- True if held, else false.
Definition at line 112 of file Button.h.
◆ isIdle()
Determine if the button is currently idle (unpressed for a "long" time).
- Returns
- True if idle, else false.
Definition at line 121 of file Button.h.
◆ isPressed()
Determine if the button is currently pressed.
- Returns
- True if pressed, else false.
Definition at line 103 of file Button.h.
◆ nextId()
static uint8_t able::Pin::nextId |
( |
| ) |
|
|
inlinestaticprotectedinherited |
Return the next auto-assigned button identifier.
- Returns
- The next auto-assigned button identifier. Each call increases the auto-assigned identifier.
Definition at line 29 of file Pins.h.
◆ readPin()
void able::Pin::readPin |
( |
| ) |
|
|
inlineprotectedinherited |
Read the pin directly.
In order to save memory, virtual functions are not used (which can consume almost 1K of memory to deal with). Runtime polymorphism is not required, so avoiding virtual functions saves memory.
Definition at line 62 of file Pins.h.
◆ resetClicked()
Reset the clicked state of the button, returning what is was.
This allows the click state to be effectively read once so that a clicked state only triggers something once, when checked. For example toggling something on/off when the button is clicked. For buttons that don't support clicking, the compile will fail with errors.
- Returns
- True if the button was clicked, else false.
Definition at line 71 of file Button.h.
◆ resetDoubleClicked()
Reset the double-clicked state of the button, returning what is was.
This allows the double-click state to be effectively read once so that a double-clicked state only triggers something once, when checked. For example toggling something on/off when the button is double- clicked. For buttons that don't support double-clicking, the compile will fail with errors.
- Returns
- True if the button was double-clicked, else false.
Definition at line 87 of file Button.h.
◆ autoId_
uint8_t able::Pin::autoId_ = 0 |
|
staticprotectedinherited |
Auto-assigned button identifier.
Definition at line 70 of file Pins.h.
◆ currState_
uint8_t able::Pin::currState_ |
|
protectedinherited |
The reading of the pin.
Definition at line 73 of file Pins.h.
◆ pin_
The Arduino pin connected to the button.
Definition at line 72 of file Pins.h.
The documentation for this class was generated from the following file: