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-8e6eb4d8-ffab-4dbe-a97f-03ab7b8f5ccc.svg

double_click_enable=False, triple_click_enable=False

Double click mode

_images/wavedrom-5dba9d48-1be3-441e-9773-4dd80693b27f.svg

double_click_enable=True, triple_click_enable=False

Triple click mode

_images/wavedrom-7739af4c-35eb-4215-9fc2-7557351c57f0.svg

double_click_enable=True, triple_click_enable=True

Long click mode

_images/wavedrom-a17f1a5d-a410-487e-8e82-69e30e575486.svg

long_click_enable=True