Layout
PropertyPanel
Generate Fluent property editors from explicit definitions, with groups, search, reset and validation.
Example
Usage
Edit a document title
Change the title to update the preview. Clear it to show an untitled document, or reset the field.
#include <FluentQt/Layout.h>
using namespace fluent::layout;
auto* document = new Card(this);
document->setMaximumWidth(480);
document->setBorderVisible(false);
auto* body = new QVBoxLayout(document);
body->setContentsMargins(16, 16, 16, 16);
body->setSpacing(12);
auto* identity = new QHBoxLayout;
identity->setSpacing(8);
auto* icon = new FontIcon(Typography::Icons::Document, document);
icon->setIconSize(20);
identity->addWidget(icon);
auto* preview = new Label("Quarterly report", document);
preview->setFluentTypography(Typography::FontRole::Body);
preview->setTextColorRole(Label::TextColorRole::Primary);
preview->setTextFormat(Qt::PlainText);
preview->setTextElideMode(Qt::ElideRight);
preview->setMinimumWidth(0);
preview->setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Preferred);
identity->addWidget(preview, 1);
auto* panel = new fluent::layout::PropertyPanel(document);
panel->setLayoutMode(fluent::layout::PropertyPanel::LayoutMode::Stacked);
fluent::layout::PropertyDefinition title;
title.key = "title";
title.label = "Title";
title.defaultValue = QStringLiteral("Quarterly report");
panel->setProperties({title});
panel->setFixedHeight(64);
body->addWidget(panel);
body->addLayout(identity);
connect(panel, &fluent::layout::PropertyPanel::valueEdited, preview,
[preview](const QString&, const QVariant& value) {
const QString title = value.toString().trimmed();
preview->setText(title.isEmpty() ? QStringLiteral("Untitled document") : title);
});import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QHBoxLayout, QSizePolicy, QVBoxLayout
document = fluentqt.Card()
document.setObjectName("propertyDocumentSample")
document.setMaximumWidth(480)
document.setBorderVisible(False)
body = QVBoxLayout(document)
body.setContentsMargins(16, 16, 16, 16)
body.setSpacing(12)
identity = QHBoxLayout()
identity.setSpacing(8)
icon = fluentqt.FontIcon(fluentqt.Typography.Icons.Document, document)
icon.setIconSize(20)
identity.addWidget(icon)
preview = fluentqt.Label("Quarterly report", document)
preview.setObjectName("propertyDocumentTitle")
preview.setFluentTypography(fluentqt.FontRole.Body)
preview.setTextColorRole(fluentqt.Label.TextColorRole.Primary)
preview.setTextFormat(Qt.PlainText)
preview.setTextElideMode(Qt.ElideRight)
preview.setMinimumWidth(0)
preview.setSizePolicy(QSizePolicy.Ignored, QSizePolicy.Preferred)
identity.addWidget(preview, 1)
panel = fluentqt.PropertyPanel(document)
panel.setObjectName("documentProperties")
panel.setLayoutMode(fluentqt.PropertyPanel.LayoutMode.Stacked)
title = fluentqt.PropertyDefinition()
title.key = "title"
title.label = "Title"
title.defaultValue = "Quarterly report"
panel.setProperties([title])
panel.setFixedHeight(64)
body.addWidget(panel)
body.addLayout(identity)
def update_title(key, value):
preview.setText(value.strip() or "Untitled document")
panel.valueEdited.connect(update_title)API
DeclarationNo matching API members.
fluent::layout::PropertyPanel
Inherits QWidget · FluentElement · QMLPlus
A bounded property form composed of Fluent editors, search, groups and reset actions.
Constructors
Properties
QString searchText- Read
searchText()WritesetSearchText()NotifysearchTextChanged() bool readOnly- Read
isReadOnly()WritesetReadOnly()NotifyreadOnlyChanged() LayoutMode layoutMode- Read
layoutMode()WritesetLayoutMode()NotifylayoutModeChanged() SearchVisibility searchVisibility- Read
searchVisibility()WritesetSearchVisibility()NotifysearchVisibilityChanged() QStringList modifiedPropertyKeys- Read
modifiedPropertyKeys()NotifymodifiedPropertiesChanged()
Methods
bool setProperties(const QVector<PropertyDefinition>& properties)Atomically replaces definitions; invalid or duplicate keys leave the form unchanged.
bool setValue(const QString& key, const QVariant& value)Updates a known editor using its declared type; rejects invalid values and tracks changes.
bool resetProperty(const QString& key)Applies a declared default and emits valueEdited only for a real editable change.
void resetAll()Resets editable properties with defaults, including filtered fields.
QWidget* editor(const QString& key) constBorrows the generated editor/Field; pointers expire when definitions are replaced.
Signals
Enumerations
enum class LayoutModeAutomatic layout fits labels beside editors when space permits.
AutomaticStackedInline
enum class SearchVisibilityAutomatic search appears for eight or more fields or a nonempty query.
AutomaticVisibleHidden
Destructors
Subclass interfaces
Methods
Inherited from fluent::FluentElement
Methods
static void setTheme(Theme theme)Updates the global theme and notifies active FluentElement instances.
static void setThemeDeferred(Theme theme)Schedules a visible-first batched theme refresh without blocking the current interaction.
static Theme currentTheme()Returns the currently active global theme.
static bool themeUsesDarkAppearance(Theme theme)Returns whether a theme uses dark-backed chrome and material tokens.
static void refreshTheme()Re-broadcasts the current theme to repaint after a design-token change.
static int themeGeneration()Monotonic counter bumped on every theme change, for staleness checks.
Theme effectiveTheme() constResolves the theme used by this element, honoring an inherited QWidget override.
bool effectiveThemeUsesDarkAppearance() constReturns whether this element's effective theme uses dark-backed chrome.
bool setThemeOverrides(const QJsonObject& overrides)Component-facing token accessors.
QJsonObject themeOverrides() constReturns this element's authored overrides.
void clearThemeOverrides()Restores all token fields to global theme defaults.
const Colors& themeColorsRef() constNon-copying access to the active color set (for hot paint paths).
Material::AcrylicToken themeAcrylic() constMaterial, elevation, and adaptive layout tokens.
QColor themeBackdrop(bool active) constWindow-chrome backdrop color for the given activation state.
virtual void onThemeUpdated()Called after the global theme changes.
Enumerations
enum ThemeGlobal visual theme used when resolving design tokens.
Light = 0Dark = 1HighContrast = 2
Types and aliases
struct ColorsDesign token snapshots returned to components.
Inherited from fluent::QMLPlus
Methods
AnchorLayout::Anchors* anchors()Returns mutable anchors for the QWidget host.
void setState(const QString& name)Applies a named state, or clears state when name is empty.
void addState(const QMLState& state)Registers or replaces a named state definition.
void evaluateStates()Reevaluates conditions; the first registered true condition wins.
QMLPlusRuntime* runtime()Returns the lazy host-owned state observation object.
void setAnchors(const AnchorLayout::Anchors& anchors)Replaces all host anchors and invalidates the parent layout.
void resetAnchors()Clears all host anchors and invalidates the parent layout.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Binds a source property to a property on the QWidget host.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installs a managed direct binding on this QWidget host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installs an explicit-dependency C++ expression on this QWidget host.
void addTransition(const StateTransition& transition)Registers a state transition in precedence order.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Sets the default animation for this host's managed property writes.
void clearBehavior(const char* propertyName)Removes the default animation for future managed writes.
bool writeProperty(const char* propertyName, const QVariant& value)Writes a host property through Behavior without removing its binding.
All inherited Qt members：QWidget
fluent::layout::PropertyDefinition
Explicit metadata for one generated editor; business values remain application-owned.
Enumerations
enum TypeTextNumberBooleanChoiceColor