Back to all docs
API Reference / Telerik.Windows.Controls / RadCircularProgressBar

Class
RadCircularProgressBar

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:
cs-api-definition
[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.

Declaration

cs-api-definition
public RadCircularProgressBar()

Fields

EndAngleProperty

Identifies the EndAngle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty EndAngleProperty

Field Value

DependencyProperty

IndeterminateIndicatorRatioProperty

Identifies the IndeterminateIndicatorRatio dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndeterminateIndicatorRatioProperty

Field Value

DependencyProperty

IndicatorEndRadiusProperty

Identifies the IndicatorEndRadius dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndicatorEndRadiusProperty

Field Value

DependencyProperty

IndicatorFillProperty

Identifies the IndicatorFill dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndicatorFillProperty

Field Value

DependencyProperty

IndicatorStartRadiusProperty

Identifies the IndicatorStartRadius dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndicatorStartRadiusProperty

Field Value

DependencyProperty

IndicatorStrokeProperty

Identifies the IndicatorStroke dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndicatorStrokeProperty

Field Value

DependencyProperty

IndicatorThicknessProperty

Identifies the IndicatorThickness dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IndicatorThicknessProperty

Field Value

DependencyProperty

SecondaryIndicatorFillProperty

Identifies the SecondaryIndicatorFill dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SecondaryIndicatorFillProperty

Field Value

DependencyProperty

SecondaryValueProperty

Identifies the SecondaryValue dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SecondaryValueProperty

Field Value

DependencyProperty

SegmentsDensityProperty

Identifies the SegmentsDensity dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SegmentsDensityProperty

Field Value

DependencyProperty

SegmentsProperty

Identifies the Segments dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SegmentsProperty

Field Value

DependencyProperty

StartAngleProperty

Identifies the StartAngle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty StartAngleProperty

Field Value

DependencyProperty

TrackEndRadiusProperty

Identifies the TrackEndRadius dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TrackEndRadiusProperty

Field Value

DependencyProperty

TrackFillProperty

Identifies the TrackFill dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TrackFillProperty

Field Value

DependencyProperty

TrackStartRadiusProperty

Identifies the TrackStartRadius dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TrackStartRadiusProperty

Field Value

DependencyProperty

UseRoundedSegmentsProperty

Identifies the UseRoundedSegments dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty UseRoundedSegmentsProperty

Field Value

DependencyProperty

Properties

ColorRanges

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

Declaration

cs-api-definition
public ObservableCollection<ProgressBarColorRange> ColorRanges { get; }

Property Value

ObservableCollection<ProgressBarColorRange>

EndAngle

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

Declaration

cs-api-definition
public double EndAngle { get; set; }

Property Value

double

IndeterminateIndicatorRatio

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

Declaration

cs-api-definition
public double IndeterminateIndicatorRatio { get; set; }

Property Value

double

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.

Declaration

cs-api-definition
public double IndicatorEndRadius { get; set; }

Property Value

double

IndicatorFill

Gets or sets the fill of the indicator.

Declaration

cs-api-definition
public Brush IndicatorFill { get; set; }

Property Value

Brush

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.

Declaration

cs-api-definition
public double IndicatorStartRadius { get; set; }

Property Value

double

IndicatorStroke

Gets or sets the stroke of the indicator.

Declaration

cs-api-definition
public Brush IndicatorStroke { get; set; }

Property Value

Brush

IndicatorThickness

Gets or sets the stroke thickness of the indicator.

Declaration

cs-api-definition
public double IndicatorThickness { get; set; }

Property Value

double

SecondaryIndicatorFill

Gets or sets the fill of the secondary indicator.

Declaration

cs-api-definition
public Brush SecondaryIndicatorFill { get; set; }

Property Value

Brush

SecondaryValue

Gets or sets the value visualized by the secondary indicator.

Declaration

cs-api-definition
public double SecondaryValue { get; set; }

Property Value

double

Segments

Gets or sets the number of segments.

Declaration

cs-api-definition
public int Segments { get; set; }

Property Value

int

SegmentsDensity

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

Declaration

cs-api-definition
public double SegmentsDensity { get; set; }

Property Value

double

StartAngle

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

Declaration

cs-api-definition
public double StartAngle { get; set; }

Property Value

double

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.

Declaration

cs-api-definition
public double TrackEndRadius { get; set; }

Property Value

double

TrackFill

Gets or sets the fill of the track.

Declaration

cs-api-definition
public Brush TrackFill { get; set; }

Property Value

Brush

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.

Declaration

cs-api-definition
public double TrackStartRadius { get; set; }

Property Value

double

UseRoundedSegments

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

Declaration

cs-api-definition
public bool UseRoundedSegments { get; set; }

Property Value

bool

Methods

MeasureOverride(Size)

Declaration

cs-api-definition
protected override Size MeasureOverride(Size constraint)

Parameters

constraint

Size

Returns

Size

OnApplyTemplate()

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

Declaration

cs-api-definition
public override void OnApplyTemplate()

Overrides RadProgressBar.OnApplyTemplate()

OnCreateAutomationPeer()

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

Declaration

cs-api-definition
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.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

Overrides RadProgressBar.OnInitialized(EventArgs)

OnRenderSizeChanged(SizeChangedInfo)

Declaration

cs-api-definition
protected override void OnRenderSizeChanged(SizeChangedInfo sizeInfo)

Parameters

sizeInfo

SizeChangedInfo

OnValueChanged(double, double)

Raises the routed event.

Declaration

cs-api-definition
protected override void OnValueChanged(double oldValue, double newValue)

Parameters

oldValue

double

Old value of the property.

newValue

double

New value of the property.

Overrides RadProgressBar.OnValueChanged(double, double)

ResetTheme()

Resets the theme.

Declaration

cs-api-definition
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