ConfigWindow

The app's one settings page, and the framed window that remains only for a call with no parent window.

Inherits QWidget

In the namespace config::ui. Declared in src/libs/libconfigui/configui/ConfigWindow.hpp.

Detailed description

⚠ **The app's settings are a page of its window, an activity** (owner rulings R14 and R16, 2026-10-11, superseding the window of config-ui §CFG-2.4). show() pushes a ConfigView in full mode on the window's activity stack, or on the window's standalone screen host, which it makes when the app made none. No app opens the framed window below. It opens only for a null parent, for example config.window.open when no window of the app has focus.

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, and no platform predicate decides it.

In this section