power_gesture

#include "crosspad-gui/components/power_gesture.h"

Generated from crosspad-gui/components/power_gesture.h in crosspad-gui. Edit the header’s doxygen comments to change this page.

Portable resolution of the hardware power button’s two GUI gestures.

Recipes that use it: UI kit

Functions

const char * backResultName(BackResult r)

uint32_t ui_back_push(BackHandlerFn fn, void *user_data)

Returns a token, or 0 when the stack is full. The most recently pushed handler is asked first.

Used in UI kit.

void ui_back_remove(uint32_t token)

Drop a registration. Safe to call with 0 or an already-removed token.

Used in UI kit.

bool ui_back_has_overlay()

True while at least one overlay is registered.

BackResult powerBack()

Contextual “back” — the short click of the power button.

Resolved most-local-first:

void powerButtonPress()

Press / release of an emulated power button (the simulator’s on-screen button, a keyboard key, a control-port verb).

Does the same click-vs-hold split the firmware does from its register poll, on an LVGL timer.

void powerButtonRelease()

bool powerToggleQuickSettings()

Toggle the status-bar quick-settings drawer — the 0.5 s hold.

No-op when the drawer is disabled in settings (no arrow button exists).

What powerBack() did, for logging and tests.

Value	Value	Description
`None`	`0`	nothing was open; the launcher stays as it is
`Dropdown`		an open dropdown/picker was closed
`Overlay`		a modal on the overlay layer was cancelled
`Editing`		the encoder group left edit mode
`Drawer`		the quick-settings drawer was closed
`Transport`		the encoder’s focus went back from the top bar to the screen
`App`		the running app handled it, or was closed

using crosspad_gui::BackHandlerFn = bool (*)(void* user_data)

Return true if the handler consumed the gesture (and tore its overlay down).

Declaration	Description
`constexpr uint32_t kPowerHoldMs`	The hold threshold both platforms use, and the STM32’s own LONG_PRESS_SLEEP_MS: under it a press is a click, at it the hold fires.