Collections
SplitView
Hosts resizable panes separated by draggable handles.
Example
Usage
Resizable panes
Drag the handle between the panes to resize them.
#include <FluentQt/Collections.h>
using namespace fluent::collections;
auto* splitView = new SplitView(this);
splitView->addPane(firstPane);
splitView->addPane(secondPane);
splitView->addPane(thirdPane);
splitView->setPanePreferredSize(0, 150);
splitView->setPaneFill(2, true);import fluentqt
split_view = fluentqt.SplitView()
split_view.addOwnedPane(first_pane)
split_view.addOwnedPane(second_pane)
split_view.addOwnedPane(third_pane)
split_view.setPanePreferredSize(0, 150)
split_view.setPaneFill(2, True)API
DeclarationNo matching API members.
fluent::collections::SplitView
Inherits QWidget · FluentElement · QMLPlus
Resizable multi-pane container with Fluent splitter handles.
Constructors
Properties
Qt::Orientation orientationPrimary layout or motion orientation.
Readorientation()WritesetOrientation()NotifyorientationChanged()bool resizingWhether a split handle is actively being dragged.
Readresizing()NotifyresizingChanged()int handleWidthInteractive width of the split handle.
ReadhandleWidth()WritesetHandleWidth()NotifyhandleWidthChanged()int handleVisualThicknessPainted thickness of the split handle indicator.
ReadhandleVisualThickness()WritesetHandleVisualThickness()NotifyhandleVisualThicknessChanged()int fillPaneIndexPane index that consumes remaining SplitView space.
ReadfillPaneIndex()WritesetFillPaneIndex()NotifyfillPaneIndexChanged()QSize defaultSizeHintFallback pane size hint when a pane does not provide one.
ReaddefaultSizeHint()WritesetDefaultSizeHint()NotifydefaultSizeHintChanged()QSize defaultMinimumSizeHintFallback pane minimum size hint.
ReaddefaultMinimumSizeHint()WritesetDefaultMinimumSizeHint()NotifydefaultMinimumSizeHintChanged()
Methods
int addPane(QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())Appends a pane with an explicit release policy.
int insertPane(int index, QWidget* pane, WidgetOwnership ownership, const SplitViewPaneOptions& options = SplitViewPaneOptions())Inserts a pane with an explicit release policy.
bool removePane(QWidget* pane)Legacy removal that transfers the pane to the caller.
QWidget* removePaneAt(int index)Legacy indexed removal that transfers the pane to the caller.
bool releasePane(QWidget* pane)Removes a pane and applies its configured ownership policy.
bool releasePaneAt(int index)Removes an indexed pane and applies its ownership policy.
QWidget* takePaneAt(int index)Removes a pane without deleting it and transfers it to the caller.
WidgetOwnership paneOwnershipAt(int index) constReturns the configured release policy for a hosted pane.
Qt::Orientation orientation() constPrimary layout or motion orientation.
void setOrientation(Qt::Orientation orientation)Primary layout or motion orientation.
bool resizing() constWhether a split handle is actively being dragged.
int handleWidth() constInteractive width of the split handle.
void setHandleWidth(int width)Interactive width of the split handle.
int handleVisualThickness() constPainted thickness of the split handle indicator.
void setHandleVisualThickness(int thickness)Painted thickness of the split handle indicator.
int fillPaneIndex() constPane index that consumes remaining SplitView space.
void setFillPaneIndex(int index)Pane index that consumes remaining SplitView space.
QSize defaultSizeHint() constFallback pane size hint when a pane does not provide one.
void setDefaultSizeHint(const QSize& size)Fallback pane size hint when a pane does not provide one.
QSize defaultMinimumSizeHint() constFallback pane minimum size hint.
void setDefaultMinimumSizeHint(const QSize& size)Fallback pane minimum size hint.
Signals
void orientationChanged(Qt::Orientation orientation)Primary layout or motion orientation.
void resizingChanged(bool resizing)Whether a split handle is actively being dragged.
void handleWidthChanged(int width)Interactive width of the split handle.
void handleVisualThicknessChanged(int thickness)Painted thickness of the split handle indicator.
void fillPaneIndexChanged(int index)Pane index that consumes remaining SplitView space.
void defaultSizeHintChanged(const QSize& size)Fallback pane size hint when a pane does not provide one.
void defaultMinimumSizeHintChanged(const QSize& size)Fallback pane minimum size hint.
Destructors
PySide6 additions
addOwnedPane(pane, options=None)Append a pane deleted when it leaves the SplitView.
addBorrowedPane(pane, options=None)Append a pane detached when it leaves the SplitView.
addReparentedPane(pane, options=None)Append a pane restored to its current QWidget parent.
insertOwnedPane(index, pane, options=None)Insert a pane deleted when it leaves the SplitView.
insertBorrowedPane(index, pane, options=None)Insert a pane detached when it leaves the SplitView.
insertReparentedPane(index, pane, options=None)Insert a pane restored to its current QWidget parent.
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