Events

The Button object can detect single, double, triple and long clicks. The double_click_max_duration parameter determines how close together clicks have to be before they are considered a double click (or triple click). A long click is fired after the button has been pressed for long_click_min_duration seconds. Note that the button does not have to be released for this to happen, and you do not receive a single/double/triple click after that.

The following timing diagrams demonstrate what events are triggered depending on which params have been set. (t_double is double_click_max_duration and t_long is long_click_min_duration)

Single click mode

_images/wavedrom-b1eed090-e865-470d-bca7-f1ef082535ed.svg

double_click_enable=False, triple_click_enable=False

Double click mode

_images/wavedrom-73f4b369-fe13-4ccc-ae9c-83476777da32.svg

double_click_enable=True, triple_click_enable=False

Triple click mode

_images/wavedrom-840a0c9d-9429-4cb8-91d5-1a5d3d5c502f.svg

double_click_enable=True, triple_click_enable=True

Long click mode

_images/wavedrom-8b3fbf29-bc12-4621-94a5-954106cc3cf1.svg

long_click_enable=True