Class

RadProgressBar

Initializes a new instance of the RadProgressBar class.

Declaration

public RadProgressBar()

Gets or sets the background image of the RadProgressBar.

Declaration

public override Image BackgroundImage { get; set; }

Property Value

Overrides Control.BackgroundImage

Gets or sets the layout of the background image of the RadProgressBar.

Declaration

public override ImageLayout BackgroundImageLayout { get; set; }

Property Value

Overrides Control.BackgroundImageLayout

Indicates whether the progress bar style is dash. When style is dash the progress line is broken into segments with separators in between them.

Declaration

public bool Dash { get; set; }

Property Value

Gets the default size for the progress bar control.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

Indicates whether the progress bar style is hatch. When style is hatch the progress line is covered with a hatch. You will have to change the SweepAngle in order to see the style.

Declaration

public bool Hatch { get; set; }

Property Value

Gets or sets the image displayed in the progress indicator.

Declaration

public Image Image { get; set; }

Property Value

Gets or sets the alignment of the image of the progress line.

Declaration

public ContentAlignment ImageAlignment { get; set; }

Property Value

Gets or sets the index of the image from the associated ImageList to display in the progress indicator.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int ImageIndex { get; set; }

Property Value

Gets or sets the key of the image from the associated ImageList to display in the progress indicator.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string ImageKey { get; set; }

Property Value

Gets or sets the layout of the image in the progress indicator.

Declaration

public ImageLayout ImageLayout { get; set; }

Property Value

When style is dash indicates if the progress indicators will progress on steps or smoothly.

Declaration

public bool IntegralDash { get; set; }

Property Value

Gets or sets the maximum value for the progress.

Declaration

public int Maximum { get; set; }

Property Value

Gets or sets the minimum value for the progress.

Declaration

public int Minimum { get; set; }

Property Value

Gets the instance of RadProgressBarElement wrapped by this control. RadProgressBarElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadProgressBar.

Declaration

[Browsable(false)]
public RadProgressBarElement ProgressBarElement { get; }

Property Value

Gets or sets the progress orientation: Bottom, Left, Right, Top.

Declaration

public ProgressOrientation ProgressOrientation { get; set; }

Property Value

Gets or sets the first gradient color for separators

Declaration

public Color SeparatorColor1 { get; set; }

Property Value

Gets or sets the second gradient color for separators.

Declaration

public Color SeparatorColor2 { get; set; }

Property Value

Gets or sets the third gradient color for separators.

Declaration

public Color SeparatorColor3 { get; set; }

Property Value

Gets or sets the fourth gradient color for separators.

Declaration

public Color SeparatorColor4 { get; set; }

Property Value

Gets or sets the fourth gradient color for separators.

Declaration

public int SeparatorGradientAngle { get; set; }

Property Value

Gets or sets the first color stop in the separator gradient.

Declaration

public float SeparatorGradientPercentage1 { get; set; }

Property Value

Gets or sets the second color stop in the separator gradient.

Declaration

public float SeparatorGradientPercentage2 { get; set; }

Property Value

Gets or sets the number of colors used in the separator gradient.

Declaration

public int SeparatorNumberOfColors { get; set; }

Property Value

Gets or sets the separators width in pixels.

Declaration

public int SeparatorWidth { get; set; }

Property Value

Gets or sets if the progress should be show with percentages.

Declaration

public bool ShowProgressIndicators { get; set; }

Property Value

Gets or sets a value indicating the amount to increment the current value with.

Declaration

public int Step { get; set; }

Property Value

Gets or sets the StepWidth between different separators.

Declaration

public int StepWidth { get; set; }

Property Value

Gets or sets the angle at which the dash or hatch lines are tilted.

Declaration

public int SweepAngle { get; set; }

Property Value

Gets or sets the text associated with this control.

Declaration

[Bindable(true)]
public override string Text { get; set; }

Property Value

Overrides RadControl.Text

Gets or sets the alignment of the text content on the drawing surface.

Declaration

public ContentAlignment TextAlignment { get; set; }

Property Value

Gets or sets the text orientation in the progress bar.

Declaration

public Orientation TextOrientation { get; set; }

Property Value

Gets or sets the value of the first progress line. There could be two progress lines in the progress bar.

Declaration

public int Value1 { get; set; }

Property Value

Gets or sets the value of the second progress line. There could be two progress lines in the progress bar.

Declaration

public int Value2 { get; set; }

Property Value

Creates the child elements that make up the progress bar structure.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Creates and returns a new instance of RadProgressBarElement that provides the core functionality for this progress bar.

Declaration

protected virtual RadProgressBarElement CreateProgressBarElement()

Returns

Raises the appropriate event based on the specified ProgressBarEventArgs.

Declaration

protected virtual void OnPropertyChanged(ProgressBarEventArgs e)

Parameters

Resets background color theme overrides by clearing custom overrides and applying the current theme.

Declaration

protected override void ResetBackColorThemeOverrides()

Overrides RadControl.ResetBackColorThemeOverrides()

Resets foreground color theme overrides by clearing custom overrides and applying the current theme.

Declaration

protected override void ResetForeColorThemeOverrides()

Overrides RadControl.ResetForeColorThemeOverrides()

Sets theme overrides for the background color by applying the specified color across all visual states.

Declaration

protected override void SetBackColorThemeOverrides()

Overrides RadControl.SetBackColorThemeOverrides()

Sets theme overrides for the foreground color by applying the specified color across all visual states.

Declaration

protected override void SetForeColorThemeOverrides()

Overrides RadControl.SetForeColorThemeOverrides()

Occurs when the dash property is changed.

Declaration

public event RadProgressBar.ProgressBarHandler DashChanged

Event Value

Occurs when the hatch property is changed.

Declaration

public event RadProgressBar.ProgressBarHandler HatchChanged

Event Value

Occurs when the integral dash property is changed.

Declaration

public event RadProgressBar.ProgressBarHandler IntegralDashChanged

Event Value

Occurs when the maximum property is changed.

Declaration

public event RadProgressBar.ProgressBarHandler MaximumChanged

Event Value

Occurs when the minimum property is changed.

Declaration

public event RadProgressBar.ProgressBarHandler MinimumChanged

Event Value

Occurs when the progress orientation is changed.

Declaration

public event RadProgressBar.ProgressBarHandler ProgressOrientationChanged

Event Value

Occurs when the separator color is changed.

Declaration

public event RadProgressBar.ProgressBarHandler SeparatorColorChanged

Event Value

Occurs when the separator width is changed.

Declaration

public event RadProgressBar.ProgressBarHandler SeparatorWidthChanged

Event Value

Occurs when show progress indicators is changed.

Declaration

public event RadProgressBar.ProgressBarHandler ShowProgressIndicatorsChanged

Event Value

Occurs when the step is changed.

Declaration

public event RadProgressBar.ProgressBarHandler StepChanged

Event Value

Occurs when the step width is changed.

Declaration

public event RadProgressBar.ProgressBarHandler StepWidthChanged

Event Value

Occurs when the text alignment is changed.

Declaration

public event RadProgressBar.ProgressBarHandler TextAlignmentChanged

Event Value

Occurs when the text orientation is changed.

Declaration

public event RadProgressBar.ProgressBarHandler TextOrientationChanged

Event Value

Occurs when the value is changed.

Declaration

public event RadProgressBar.ProgressBarHandler ValueChanged

Event Value