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

Progress Indication

The RadTaskbarButton component provides you with the possibility to display the progress of a task in the taskbar. To set the progress you need to use the ProgressPercentage property. Its value should be between 0 and 100. You can control the progress by increasing this property.

In the following example, we are going to simulate the progress of a running task in the taskbar. On each second, the ProgressPercentage property is increased by 10 percent.


Timer timer = new Timer();
void ShowTaskProgress()
{
    timer.Interval = 1000;
    timer.Tick += Timer_Tick;
    timer.Start();
}

private void Timer_Tick(object sender, System.EventArgs e)
{
    this.radTaskbarButton1.ProgressPercentage += 10;
}

Private timer As Timer = New Timer()

Private Sub ShowTaskProgress()
    timer.Interval = 1000
    timer.Tick += AddressOf Timer_Tick
    timer.Start()
End Sub

Private Sub Timer_Tick(ByVal sender As Object, ByVal e As System.EventArgs)
    Me.radTaskbarButton1.ProgressPercentage += 10
End Sub


Progress State

The progress visualization of the taskbar can be also controlled by the ProgressState property. This way you can add more information to the end user regarding the currently running task progress state. The ProgressState property is an enumeration and it exposes the following values.

NoProgress

In this state, no progress visualization will appear.

WinForms RadTaskbarButton ProgressState NoProgress

Error

In this state, the progress color will be set to red to indicate that an error appears while the task was running.

WinForms RadTaskbarButton ProgressState Error

Indeterminate

In this state the progress bar won't respect the ProgressPercentage property value, it will continue to load until you set a different state.

WinForms RadTaskbarButton ProgressState Indeterminate

Normal

In this state, the progress will appear in its default visualization.

WinForms RadTaskbarButton ProgressState Normal

Pause

In this state, the color of the progress will turn into yellow. In this state, the ProgressPercentage property value change should be stopped to show that the currently running task is on pause.

WinForms RadTaskbarButton ProgressState Pause

See Also

In this article