ShellWindowSupport¶

Shared install/presenter glue for ShellWindow.

import QWinUI3.Extras · src/extras/QWinUI3/Extras/ShellWindowSupport.qml

Category: Shells & windows · Library: v2.80

Internal / support type — not part of the public Gallery surface.

Extends Item.

Example¶

ShellWindowSupport {
    id: shellWindowSupport
    targetWindow: root; autoInstall: true
}

// --- API ---
// methods: applyChrome(), applyPresenter(), applyAlwaysOnTop(), centerOnScreen(),
//          saveGeometry(), restoreGeometry(), clearSavedGeometry()
// Reacts to paradigm / backdrop / presenter / isAlwaysOnTop changes.

Notes¶

installParadigmEx for Standard/Dialog/Tool + presenter + always-on-top. FullScreen presenter is applied after install so the HWND exists first. geometryPersistenceKey → QSettings WindowGeometry/ via WindowHelper.

API¶

Properties¶

Name	Type	Description
`targetWindow`	`var`	Window this chrome is attached to
`paradigm`	`int`	WindowHelper.Paradigm* kind
`backdrop`	`int`	WindowHelper.Backdrop* material
`presenter`	`int`	WindowHelper.Presenter* kind
`isAlwaysOnTop`	`bool`	Keep window above others
`autoInstall`	`bool`	Auto-apply WindowHelper chrome on complete
`extendsContentIntoTitleBar`	`bool`	Custom frame / extend content
`geometryPersistenceKey`	`string`	Non-empty → save/restore target window geometry (QSettings WindowGeometry/).
`geometryPersistenceEnabled`	`bool`	—
`syncThemeFromSystem`	`bool`	Copy OS a11y / color scheme into Theme (1.69).

Signals¶

Signature	Description
`geometryRestored()`	Emitted after restoreGeometry() completes (2.54 hit-test refresh).

Methods¶

Signature	Description
`applyChrome()`	Apply window chrome / backdrop / paradigm flags
`applyPresenter()`	Apply presenter only (Overlapped / FullScreen / CompactOverlay)
`applyAlwaysOnTop()`	Apply always-on-top flag
`centerOnScreen()`	Center the target window on the current screen
`syncThemeDpi()`	Push this window's screen DPR into Theme (hairlines / diagnostics).
`saveGeometry()`	—
`restoreGeometry()`	—
`clearSavedGeometry()`	—

Inherited from `Item`¶

Also available (base type / Qt Quick Controls):

width / height
visible
anchors

Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.