config::ui::ConfigWindow

The settings window of one app: a non-modal framed window around a ConfigView.

Detailed description

⚠ **The app's settings are a page of its window, an activity, wherever the window can host one** (owner, 2026-10-11, superseding the window of config-ui §CFG-2.4 there). show() pushes the same ConfigView in full mode on the window's activity stack, or on its standalone screen host for an app with no stack, such as Construct. The framed window below remains for a parent that has neither.

The window is a QWidget with the Qt::Dialog flag and the app's main window as its parent. On X11 the xcb plugin marks a window as transient for its parent only for Dialog, Tool and a few others, so a plain Qt::Window falls behind the app when the operator clicks the app. Qt::Tool is refused: it is frameless in this tree's style and hides with its parent (config-ui §CFGV-7).

Its geometry is saved under `ui/config/<app>/geometry` and restored with restoreGeometry(), which moves an off-screen window back onto a screen. Wayland refuses a client position, so there only the size comes back.

On a platform with one top-level window, for example Android, a window of its own was never possible, which is where the activity began (config-ui §CFGV-7). Since 2026-10-11 it is the rule everywhere.