SettingsGroup¶

Section header + card stack for settings pages.

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

Category: Layout · Library: v2.80

Gallery: SettingsGroup — src/gallery/pages/SettingsGroupPage.qml

Extends Control.

Example¶

SettingsGroup {
    title: qsTr("Appearance")
    description: qsTr("Theme and motion preferences.")
    SettingsCard { title: qsTr("Dark mode"); toggle: true; checked: … }
    SettingsCard { title: qsTr("Density"); action: ComboBox {} }
}

Notes¶

Groups SettingsCard / SettingsExpander rows under a Fluent section title. Cards declare Layout.fillWidth themselves — no parent walk needed. Prefer SettingsCard { toggle: true } over action: Switch {…}. Prefer nesting inside SettingsView for page padding/title (Gallery Settings pages are SettingsView hosts, not CatalogPage).

API¶

Properties¶

Name	Type	Description
`title`	`string`	Section title
`header`	`alias`	Toolkit Header alias
`description`	`string`	Supporting description under the title
`symbol`	`var`	Optional Fluent symbol before the title
`iconGlyph`	`string`	Raw glyph fallback
`contentSpacing`	`real`	Spacing between child cards
`contentData`	`alias`	Default children / card stack
`effectiveSymbol`	`string`	—

Signals¶

No custom signals (use inherited signals from the base type).

Methods¶

No custom methods (use inherited methods from the base type).

Inherited from `Control`¶

Also available (base type / Qt Quick Controls):

padding
font
background / contentItem

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