Back to all docs
API Reference / Telerik.Windows.Controls / RadCircularProgressBar
New to Telerik UI for WPF? Start a free 30-day trial

RadCircularProgressBar

Class

Represents a circular progress bar that visually indicates progress and completion. The RadCircularProgressBar is highly customizable, allowing settings for angles, segments, colors, and more. It inherits from RadProgressBar. Key features include:

  • Customizable start and end angles to define the segment of the circle that represents progress.
  • Control over the number of segments and their density, enabling varied visual representations.
  • Support for indeterminate progress state for scenarios where completion cannot be defined.
  • Options for rounded segments and color ranges for enhanced visual appeal.

Usage examples include loading indicators, visual completion meters, or any scenario where a circular representation of progress is required.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:
C#
[TelerikToolboxCategory("Data")]
public class RadCircularProgressBar : RadProgressBar

Inheritance: objectRadProgressBarRadCircularProgressBar

Inherited Members RadProgressBar.IsIndeterminatePropertyRadProgressBar.SkipValuePropertyRadProgressBar.OrientationPropertyRadProgressBar.ContentPropertyRadProgressBar.ContentTemplatePropertyRadProgressBar.ContentForegroundPropertyRadProgressBar.ContentTemplateSelectorPropertyRadProgressBar.ContentStringFormatPropertyRadProgressBar.OnPropertyChanged(DependencyPropertyChangedEventArgs)RadProgressBar.OnMaximumChanged(double, double)RadProgressBar.OnMinimumChanged(double, double)RadProgressBar.SkipValueRadProgressBar.IsIndeterminateRadProgressBar.ContentRadProgressBar.ContentTemplateRadProgressBar.ContentTemplateSelectorRadProgressBar.ContentStringFormatRadProgressBar.ContentForegroundRadProgressBar.Orientation...

Constructors

RadCircularProgressBar()

Initializes a new instance of the RadCircularProgressBar class.

C#
public RadCircularProgressBar()

Fields

EndAngleProperty

DependencyProperty

Identifies the EndAngle dependency property.

C#
public static readonly DependencyProperty EndAngleProperty

IndeterminateIndicatorRatioProperty

DependencyProperty

Identifies the IndeterminateIndicatorRatio dependency property.

C#
public static readonly DependencyProperty IndeterminateIndicatorRatioProperty

IndicatorEndRadiusProperty

DependencyProperty

Identifies the IndicatorEndRadius dependency property.

C#
public static readonly DependencyProperty IndicatorEndRadiusProperty

IndicatorFillProperty

DependencyProperty

Identifies the IndicatorFill dependency property.

C#
public static readonly DependencyProperty IndicatorFillProperty

IndicatorStartRadiusProperty

DependencyProperty

Identifies the IndicatorStartRadius dependency property.

C#
public static readonly DependencyProperty IndicatorStartRadiusProperty

IndicatorStrokeProperty

DependencyProperty

Identifies the IndicatorStroke dependency property.

C#
public static readonly DependencyProperty IndicatorStrokeProperty

IndicatorThicknessProperty

DependencyProperty

Identifies the IndicatorThickness dependency property.

C#
public static readonly DependencyProperty IndicatorThicknessProperty

SecondaryIndicatorFillProperty

DependencyProperty

Identifies the SecondaryIndicatorFill dependency property.

C#
public static readonly DependencyProperty SecondaryIndicatorFillProperty

SecondaryValueProperty

DependencyProperty

Identifies the SecondaryValue dependency property.

C#
public static readonly DependencyProperty SecondaryValueProperty

SegmentsDensityProperty

DependencyProperty

Identifies the SegmentsDensity dependency property.

C#
public static readonly DependencyProperty SegmentsDensityProperty

SegmentsProperty

DependencyProperty

Identifies the Segments dependency property.

C#
public static readonly DependencyProperty SegmentsProperty

StartAngleProperty

DependencyProperty

Identifies the StartAngle dependency property.

C#
public static readonly DependencyProperty StartAngleProperty

TrackEndRadiusProperty

DependencyProperty

Identifies the TrackEndRadius dependency property.

C#
public static readonly DependencyProperty TrackEndRadiusProperty

TrackFillProperty

DependencyProperty

Identifies the TrackFill dependency property.

C#
public static readonly DependencyProperty TrackFillProperty

TrackStartRadiusProperty

DependencyProperty

Identifies the TrackStartRadius dependency property.

C#
public static readonly DependencyProperty TrackStartRadiusProperty

UseRoundedSegmentsProperty

DependencyProperty

Identifies the UseRoundedSegments dependency property.

C#
public static readonly DependencyProperty UseRoundedSegmentsProperty

Properties

ColorRanges

Gets the list of range color definitions of the progress bar.

C#
public ObservableCollection<ProgressBarColorRange> ColorRanges { get; }

EndAngle

Gets or sets a value indicating the end angle of the progress track and indicator in degrees. Default value is 360.

C#
public double EndAngle { get; set; }

IndeterminateIndicatorRatio

Gets or sets the ratio of the indicator part which will be animated when the control is in indeterminate state.

C#
public double IndeterminateIndicatorRatio { get; set; }

IndicatorEndRadius

Gets or sets the indicator end radius (outer radius) which is relative to the radius (half size) of the RadCircularProgressBar. Default value is 1.0.

C#
public double IndicatorEndRadius { get; set; }

IndicatorFill

Brush

Gets or sets the fill of the indicator.

C#
public Brush IndicatorFill { get; set; }

IndicatorStartRadius

Gets or sets the indicator start radius (inner radius) which is relative to the radius (half size) of the RadCircularProgressBar. Default value is 0.8.

C#
public double IndicatorStartRadius { get; set; }

IndicatorStroke

Brush

Gets or sets the stroke of the indicator.

C#
public Brush IndicatorStroke { get; set; }

IndicatorThickness

Gets or sets the stroke thickness of the indicator.

C#
public double IndicatorThickness { get; set; }

SecondaryIndicatorFill

Brush

Gets or sets the fill of the secondary indicator.

C#
public Brush SecondaryIndicatorFill { get; set; }

SecondaryValue

Gets or sets the value visualized by the secondary indicator.

C#
public double SecondaryValue { get; set; }

Segments

Gets or sets the number of segments.

C#
public int Segments { get; set; }

SegmentsDensity

Gets or sets the density of the segments. It is value in range [0-1] with a default value of 0.95.

C#
public double SegmentsDensity { get; set; }

StartAngle

Gets or sets a value indicating the start angle of the progress track and indicator in degrees. Default value is 0.

C#
public double StartAngle { get; set; }

TrackEndRadius

Gets or sets the track end radius (outer radius) which is relative to the radius (half size) of the RadCircularProgressBar. Default value is 1.0.

C#
public double TrackEndRadius { get; set; }

TrackFill

Brush

Gets or sets the fill of the track.

C#
public Brush TrackFill { get; set; }

TrackStartRadius

Gets or sets the track start radius (inner radius) which is relative to the radius (half size) of the RadCircularProgressBar. Default value is 0.8.

C#
public double TrackStartRadius { get; set; }

UseRoundedSegments

Gets or sets a value indicating whether the segments are rounded. Default value is false.

C#
public bool UseRoundedSegments { get; set; }

Methods

MeasureOverride(Size)

Size

C#
protected override Size MeasureOverride(Size constraint)
Parameters:constraintSizeReturns:

Size

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call .

C#
public override void OnApplyTemplate()

Overrides: RadProgressBar.OnApplyTemplate()

OnCreateAutomationPeer()

AutomationPeer

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

Overrides: RadProgressBar.OnCreateAutomationPeer()

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Overrides: RadProgressBar.OnInitialized(EventArgs)

OnRenderSizeChanged(SizeChangedInfo)

C#
protected override void OnRenderSizeChanged(SizeChangedInfo sizeInfo)
Parameters:sizeInfoSizeChangedInfo

OnValueChanged(double, double)

Raises the routed event.

C#
protected override void OnValueChanged(double oldValue, double newValue)
Parameters:oldValuedouble

Old value of the property.

newValuedouble

New value of the property.

Overrides: RadProgressBar.OnValueChanged(double, double)

ResetTheme()

Resets the theme.

C#
public void ResetTheme()
In this article
DefinitionConstructorsRadCircularProgressBar()FieldsEndAnglePropertyIndeterminateIndicatorRatioPropertyIndicatorEndRadiusPropertyIndicatorFillPropertyIndicatorStartRadiusPropertyIndicatorStrokePropertyIndicatorThicknessPropertySecondaryIndicatorFillPropertySecondaryValuePropertySegmentsDensityPropertySegmentsPropertyStartAnglePropertyTrackEndRadiusPropertyTrackFillPropertyTrackStartRadiusPropertyUseRoundedSegmentsPropertyPropertiesColorRangesEndAngleIndeterminateIndicatorRatioIndicatorEndRadiusIndicatorFillIndicatorStartRadiusIndicatorStrokeIndicatorThicknessSecondaryIndicatorFillSecondaryValueSegmentsSegmentsDensityStartAngleTrackEndRadiusTrackFillTrackStartRadiusUseRoundedSegmentsMethodsMeasureOverride(Size)OnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnRenderSizeChanged(SizeChangedInfo)OnValueChanged(double, double)ResetTheme()
Not finding the help you need?
Contact Support