Report Progress Value

This topic will describe the scenario in which you have a determined RadBusyIndicator control which you want to be available for a predefined amount of time. In this case the RadBusyIndicator provides you out of the box with a way to visualize the progress.

To read more about the determined and indetermined RadBusyIndicator control's modes, look here.

In the following example the only content of the RadBusyIndicator control is a Button. When the user clicks on that button the RadBusyIndicator will be enabled for a predefined amount of time. In this example, this is achieved by using a DispatcherTimer timer object which Tick event will change the RadBusyIndicator's progress value.

The first thing you have to do is to specify that you want your indicator to be determined. You do this by setting its IsIndetermined boolean property to False.

Setting IsIndeterminate

• XAML

<telerik:RadBusyIndicator x:Name="radBusyIndicator"  
                          IsIndeterminate="False"  
                          ProgressValue="{Binding ProgressValue}"> 
    <Grid>                
        <Button Content="Show RadBusyIndicator" 
                VerticalAlignment="Bottom" 
                Click="showIndicatorButton_Click" /> 
    </Grid> 
</telerik:RadBusyIndicator> 

Notice that you have also defined the ProgressValue property. For the purpose of this example, by using data binding you have bound it to a property named in the same way located in the code-behind. Through this binding you will be changing this property to report any shifts in the RadBusyIndicator's progress value.

You can further change the default way of the progress changes notifications by customizing the Busy Content.

In the code behind you have to:

• Create and initialize the DispathcherTimer object.

• Handle the click event for the button:

  • Enable RadBusyIndicator by setting its IsBusy property to True.

  • Start the timer which will represent the ongoing process.

• Handle the tick event for the timer:

  • Modify the progress value.

  • Disable the RadBusyIndicator by setting its IsBusy property to False in a specific condition.

In order to use the DispatcherTimer and the INotifyPropertyChanged interface you will need to add the following usings/imports:

• System.ComponentModel
• System.Windows.Threading

ProgressDetermination class implementation

• C#
• VB

public partial class ProgressDetermination : UserControl, INotifyPropertyChanged 
{ 
    private int progressValue; 
    private DispatcherTimer progressTimer; 
    public event PropertyChangedEventHandler PropertyChanged; 
    public ProgressDetermination() 
    { 
        InitializeComponent(); 
        this.DataContext = this; 
        this.progressTimer = new DispatcherTimer(); 
        this.progressTimer.Interval = TimeSpan.FromSeconds( 0.1 ); 
        this.progressTimer.Tick += new EventHandler( this.progressTimer_Tick ); 
    } 
    public int ProgressValue 
    { 
        get 
        { 
            return this.progressValue; 
        } 
        set 
        { 
            if ( this.progressValue == value ) 
                return; 
            this.progressValue = value; 
            if ( this.PropertyChanged != null ) 
                this.PropertyChanged( this, new PropertyChangedEventArgs( "ProgressValue" ) ); 
        } 
    } 
    private void showIndicatorButton_Click( object sender, RoutedEventArgs e ) 
    { 
        this.progressTimer.Start(); 
        this.ProgressValue = 0; 
        this.radBusyIndicator.IsBusy = true; 
    } 
    private void progressTimer_Tick( object sender, EventArgs e ) 
    { 
        this.ProgressValue++; 
        if ( this.ProgressValue == 100 ) 
        { 
            this.progressTimer.Stop(); 
            this.radBusyIndicator.IsBusy = false; 
        } 
    } 
} 

Public Class ProgressDetermination 
    Implements INotifyPropertyChanged 
 
    Private m_progressValue As Integer 
    Private progressTimer As DispatcherTimer 
    Public Event PropertyChanged As PropertyChangedEventHandler _ 
         Implements INotifyPropertyChanged.PropertyChanged 
 
    Public Sub New() 
        InitializeComponent() 
        Me.DataContext = Me 
        Me.progressTimer = New DispatcherTimer() 
        Me.progressTimer.Interval = TimeSpan.FromSeconds(1) 
        AddHandler progressTimer.Tick, AddressOf progressTimer_Tick 
 
    End Sub 
    Public Property ProgressValue() As Integer 
        Get 
            Return Me.m_progressValue 
        End Get 
        Set(value As Integer) 
            If Me.m_progressValue = value Then 
                Return 
            End If 
            Me.m_progressValue = value 
            RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs("ProgressValue")) 
        End Set 
    End Property 
    Private Sub showIndicatorButton_Click(sender As Object, e As RoutedEventArgs) 
        Me.progressTimer.Start() 
        Me.ProgressValue = 0 
        Me.radBusyIndicator.IsBusy = True 
    End Sub 
    Private Sub progressTimer_Tick(sender As Object, e As EventArgs) 
        Me.ProgressValue += 10 
        If Me.ProgressValue = 100 Then 
            Me.progressTimer.Stop 
            Me.radBusyIndicator.IsBusy = False 
        End If 
    End Sub 
End Class 

Here is the final result: