Skip to main content

QCustomStepper

QCustomStepper

A step progress indicator.

A row (or column) of numbered steps with connectors, showing progress: completed / active / pending. Tokenized via a state dynamic property on the circles and connectors.

At a glance

TierFree (GPLv3)
Importfrom Custom_Widgets.QCustomStepper import QCustomStepper
Qt DesignerYes — drag it from the palette

Quick start

from Custom_Widgets.QCustomStepper import QCustomStepper

widget = QCustomStepper()

Dark theme

Colours come from the design tokens, so the widget follows the app theme with no extra work.

QCustomStepper in dark theme

Signals

Signal
currentStepChanged(int)

Methods

MethodDescription
currentStep()Current step.
currentStepChanged(...)Current step changed.
isComplete()Return whether the widget is complete.
next()Next.
previous()Previous.
setCurrentStep(index)Set the current step.
setSteps(titles)Set the steps.
stepCount()Step count.

Theming

Colours come from the design tokens, so they follow the active theme. Roles used: surface, on-surface, surface-muted, outline, accent, on-primary.

See Design tokens.

QCustomBreadcrumbs · QCustomCommandPalette · QCustomDrawer · QCustomHamburgerMenu · QCustomHeaderNav · QCustomMenu · QCustomPagination · QCustomSidebar