Status & info

ProgressBar

Shows determinate or indeterminate progress along a line.

Example

Usage

Determinate value

A determinate ProgressBar exposes range, value, ratio, and progress text.

#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;

auto* progressBar = new ProgressBar(this);
progressBar->setRange(0, 100);
progressBar->setBarWidth(320);

auto* progressBox = new NumberBox(this);
progressBox->setHeader("Progress");
progressBox->setRange(0, 100);
progressBox->setSmallChange(1);
progressBox->setLargeChange(10);
progressBox->setDisplayPrecision(0);
progressBox->setSpinButtonPlacementMode(NumberBox::SpinButtonPlacementMode::Inline);

auto* status = new Label("Progress: 44%", this);
status->setFixedWidth(124);

connect(progressBox, &NumberBox::valueChanged, progressBar, [progressBar, status](double value) {
    progressBar->setValue(std::isfinite(value) ? value : 0.0);
    status->setText(QStringLiteral("Progress: %1%").arg(progressBar->progressText()));
});
progressBox->setValue(44);

import fluentqt

import math

progress_bar = fluentqt.ProgressBar()
progress_bar.setRange(0, 100)
progress_bar.setBarWidth(320)

progress_box = fluentqt.NumberBox()
progress_box.setHeader("Progress")
progress_box.setRange(0, 100)
progress_box.setSmallChange(1)
progress_box.setLargeChange(10)
progress_box.setDisplayPrecision(0)
progress_box.setSpinButtonPlacementMode(
    fluentqt.NumberBox.SpinButtonPlacementMode.Inline
)

status = fluentqt.Label("Progress: 44%")
status.setFixedWidth(124)

def update_progress(value):
    progress_bar.setValue(value if math.isfinite(value) else 0.0)
    status.setText(f"Progress: {progress_bar.progressText()}%")

progress_box.valueChanged.connect(update_progress)
progress_box.setValue(44)

API

Declaration

`fluent::status_info::ProgressBar`

Inherits QWidget · FluentElement · QMLPlus

Fluent linear progress indicator for determinate and indeterminate work.

Constructors

explicit ProgressBar(QWidget* parent = nullptr)

Properties

bool isIndeterminate: Whether the progress indicator uses indeterminate motion.
Read isIndeterminate()Write setIsIndeterminate()Notify isIndeterminateChanged()
double minimum: Lower bound used when calculating determinate progress.
Read minimum()Write setMinimum()Notify minimumChanged()
double maximum: Upper bound used when calculating determinate progress.
Read maximum()Write setMaximum()Notify maximumChanged()
double value: Current determinate progress value between minimum and maximum.
Read value()Write setValue()Notify valueChanged()
bool showPaused: Whether paused-state visual treatment is shown.
Read showPaused()Write setShowPaused()Notify showPausedChanged()
bool showError: Whether error-state visual treatment is shown.
Read showError()Write setShowError()Notify showErrorChanged()
int barWidth: Width of the painted progress bar segment.
Read barWidth()Write setBarWidth()Notify barWidthChanged()
qreal trackThickness: Thickness of the progress track.
Read trackThickness()Write setTrackThickness()Notify trackThicknessChanged()
bool railVisible: Whether the progress rail is painted.
Read railVisible()Write setRailVisible()Notify railVisibleChanged()

Methods

bool isIndeterminate() const: Whether the progress indicator uses indeterminate motion.
void setIsIndeterminate(bool indeterminate): Whether the progress indicator uses indeterminate motion.
double minimum() const: Lower bound used when calculating determinate progress.
void setMinimum(double minimum): Lower bound used when calculating determinate progress.
double maximum() const: Upper bound used when calculating determinate progress.
void setMaximum(double maximum): Upper bound used when calculating determinate progress.
void setRange(double minimum, double maximum)
double value() const: Current determinate progress value between minimum and maximum.
void setValue(double value): Current determinate progress value between minimum and maximum.
bool showPaused() const: Whether paused-state visual treatment is shown.
void setShowPaused(bool paused): Whether paused-state visual treatment is shown.
bool showError() const: Whether error-state visual treatment is shown.
void setShowError(bool error): Whether error-state visual treatment is shown.
int barWidth() const: Width of the painted progress bar segment.
void setBarWidth(int width): Width of the painted progress bar segment.
qreal trackThickness() const: Thickness of the progress track.
void setTrackThickness(qreal thickness): Thickness of the progress track.
bool railVisible() const: Whether the progress rail is painted.
void setRailVisible(bool visible): Whether the progress rail is painted.
double progressRatio() const
QString progressText() const
bool isAnimationRunning() const
QSize sizeHint() const override
QSize minimumSizeHint() const override
void onThemeUpdated() override

Signals

void isIndeterminateChanged(bool indeterminate): Whether the progress indicator uses indeterminate motion.
void minimumChanged(double minimum): Lower bound used when calculating determinate progress.
void maximumChanged(double maximum): Upper bound used when calculating determinate progress.
void valueChanged(double value): Current determinate progress value between minimum and maximum.
void showPausedChanged(bool paused): Whether paused-state visual treatment is shown.
void showErrorChanged(bool error): Whether error-state visual treatment is shown.
void barWidthChanged(int width): Width of the painted progress bar segment.
void trackThicknessChanged(qreal thickness): Thickness of the progress track.
void railVisibleChanged(bool visible): Whether the progress rail is painted.

Destructors

~ProgressBar() override

Subclass interfaces

Methods

void paintEvent(QPaintEvent* event) override
void timerEvent(QTimerEvent* event) override
void changeEvent(QEvent* event) override
void hideEvent(QHideEvent* event) override
void showEvent(QShowEvent* event) override

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() const: Resolves the theme used by this element, honoring an inherited QWidget override.
bool effectiveThemeUsesDarkAppearance() const: Returns whether this element's effective theme uses dark-backed chrome.
bool setThemeOverrides(const QJsonObject& overrides): Component-facing token accessors.
QJsonObject themeOverrides() const: Returns this element's authored overrides.
void clearThemeOverrides(): Restores all token fields to global theme defaults.
Colors themeColors() const
const Colors& themeColorsRef() const: Non-copying access to the active color set (for hot paint paths).
FontStyle themeFont(Typography::FontRole role = Typography::FontRole::Body) const
Radius themeRadius() const
Spacing themeSpacing() const
Animation themeAnimation() const
Material::AcrylicToken themeAcrylic() const: Material, elevation, and adaptive layout tokens.
Material::MicaToken themeMica() const
Material::SmokeToken themeSmoke() const
Elevation::ShadowParams themeShadow(Elevation::Level level) const
int themeBreakpoint(Breakpoints::Breakpoint breakpoint = Breakpoints::Breakpoint::Medium) const
QColor themeBackdrop(bool active) const: Window-chrome backdrop color for the given activation state.
virtual void onThemeUpdated(): Called after the global theme changes.

Enumerations

enum Theme: Global visual theme used when resolving design tokens.
Light = 0
Dark = 1
HighContrast = 2

Types and aliases

struct Colors: Design token snapshots returned to components.
struct FontStyle
struct Radius
struct Spacing
struct Animation

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.
QString state() const
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