New to Telerik UI for WinForms? Start a free 30-day trial

Properties, Methods, and Events for RadStepProgressBar

Updated on Aug 27, 2026

Properties

PropertyDescription
StepProgressBarElementGets the RadStepProgressBarElement that represents the main element of the control.
StepsGets a collection of StepProgressItem objects that represents the different steps of the progress bar.
CurrentGets the current step. That is the step which has its progress last updated or it is last completed or cancelled.
IndicatorSizeGets or sets the size of the step indicators.
StepSpacingGets or sets the spacing between the steps.
ConnectionThicknessGets or sets the thickness of the connections.
OrientationGets or sets the orientation of the control.
HideConnectionsGets or sets whether the connection elements will be hidden.
ProgressModeDetermines how the steps are related with regard to their progress.
EnableItemInProgressVisualStateDetermines whether steps which are in progress (between 0 and 100) are visually indicated.
LayoutModeDetermines how the step items are measured and arranged in the available space.
NavigationStepDetermines the scroll step of the navigation buttons when they are visible in the Absolute layout mode.

RadStepProgressBarElement's Properties

PropertyDescription
ItemsContainerThe panel element holding the visual step items.
PreviousButtonGets the previous button of the control.
NextButtonGets the next button of the control.

StepProgressItem's Properties

PropertyDescription
ConnectionGets the connection element.
StepIndicatorGets this indicator element.
FirstContentElementGets the first content element.
SecondContentElementGets the second content element.
IndicatorSizeGets or sets the step size. If you use this property to set the step size, the property will unbind from the IndicatorSize property. In order to bind it again, you need to reset the property, using ResetIndicatorSize() method.
ConnectionLengthGets or sets the length of the connection. If you use this property to set the step spacing, the property will unbind from the StepSpacing property. In order to bind it again, you need to reset the property, using ResetConnectionLength method.
ConnectionThicknessGets or sets the thickness of the connection. If you use this property to set the step spacing, the property will unbind from the ConnectionThickness property. In order to bind it again, you need to reset the property, using ResetConnectionThickness method.
OrientationGets or sets the orientation of the step item. If you use this property to set the step spacing, the property will unbind from the Orientation property. In order to bind it again, you need to reset the property, using ResetOrientation method.
IsErrorGets or sets whether the item is in error state. If yes, the progress will change to 0.
ProgressGets or sets the progress of the step. Setting the progress of an item may affect the progress of the other items. This behavior is controlled by the StepProgressMode enum set on the element's ProgressMode property.
ProgressStatusGets the prgress status.
EnableItemInProgressVisualStateDetermines whether there is a separate visual state of the step when its progress is between 0 and 100.
CompletedGets or sets whether the step is completed. Setting this property also changes the step's Progress property. If the property is set to false, the step's progress will change to 0.
FirstHeaderGets or sets the header of the first content element.
FirstDescriptionGets or sets the description of the first content element.
SecondHeaderGets or sets the header of the second content element.
SecondDescriptionGets or sets the description of the second content element.
IsFirstDetermines if the step is first.
IsLastDetermines if the step is last.
PreviousGets the previous step.
NextGets the next step.

Methods

MethodDescription
MovePreviousTries to move the current to the previous available step. In case there is no current step or the current step is first inside the Steps collection, the position will not change.
MoveNextTries to move the Current to the next available position. In case there is no current, the next step will be the first item in the Steps collection. If the current step is at the end of the Steps collection, the position will not change.
ResetSets the current step to null.
CompleteNextIf the current step is not completed sets its progress 100. Otherwise tries to complete the next step if there is such.
CompletePreviousSets the progress of the current step to 0 and completes the previous step if there is such.
CompleteAllCompletes all steps by setting their progress to 100.
CancelAllSets the progress of all steps to 0.
CompleteStepCompletes the step by setting its progress to 100.
CancelStepSets the progress of the step to 0.
ResetIndicatorSizeResets the IndicatorSize property to the default value.
ResetStepSpacingResets the StepSpacing property to the default value.
ResetConnectionThicknessResets the ConnectionThickness property to the default value.
ResetOrientationResets the Orientation property to the default value.

Events

EventDescription
StepProgressChangingFires before updating a StepProgressItem's Progress.
StepProgressChangedFires when a StepProgressItem's Progress has been updated.
CurrentChangedFires after the Current property changes.
StepClickedFires after the StepProgressItem is clicked.

See Also