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, outline, accent, on-primary.

See Design tokens.

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