Custom Progress Bar/ Busy Indicator in Silverlight

Tags

The Silverlight toolkit comes with Busy Indicator control, but some time you may need to develop custom Busy Indicator for your application. Here are the steps to create Busy Indicator using Silverlight StoryBoard.

The Custom Busy Indicator:

1. Create Silverlight Application

Create Silverlight application and add ProgressBar.xaml user control in your project.

2. Code Progress Bar

Copy and paste below given code ten times and change grid name from circle0 through circle9. This code will be used to generate small filled circles.

<Grid x:Name="circle0" HorizontalAlignment="Center" Margin="0,0,0,0"

VerticalAlignment="Center" Opacity="0" RenderTransformOrigin="0.5,0.5">

<Grid.RenderTransform>

</TransformGroup>

</Grid.RenderTransform>

<Ellipse HorizontalAlignment="Center" Margin="0,0,0,0" Width="10"

RenderTransformOrigin="0.5,0.5" Stroke="{x:Null}" Height="10"

VerticalAlignment="Center">

<Ellipse.Fill>

</RadialGradientBrush>

</Ellipse.Fill>

<Ellipse.RenderTransform>

</TransformGroup>

</Ellipse.RenderTransform>

</Ellipse>

<Ellipse Height="9" HorizontalAlignment="Center" Margin="0,0,0,0"

Width="9" RenderTransformOrigin="0.5,0.5" VerticalAlignment="Center" Stroke="{x:Null}">

<Ellipse.Fill>

</LinearGradientBrush>

</Ellipse.Fill>

<Ellipse.RenderTransform>

</TransformGroup>

</Ellipse.RenderTransform>

</Ellipse>

</Grid>

3. Add StoryBoard code

Add this StoryBoard in user control resources section. This will start Busy Indicator animation.

<DoubleAnimation Storyboard.TargetProperty="(UIElement.Opacity)"

Storyboard.TargetName="LayoutRoot" From="0" To="1" Duration="0:0:0.3">

</DoubleAnimation>

</Storyboard>

Copy and paste below code ten times and change StoryBoard name from ProgressStoryboard0 through ProgressStoryboard9 and StoryBoard TargetName from circle0 through circle9 (you have already declared code for circles above). This code will be used to generate StoryBoard animation for Busy Indicator.

<DoubleAnimationUsingKeyFrames BeginTime="00:00:00" Storyboard.TargetName="circle0"

Storyboard.TargetProperty="(UIElement.Opacity)">

<SplineDoubleKeyFrame KeySpline="0,0,0.601999998092651,0.400999993085861"

KeyTime="00:00:00.7000000" Value="1" />

</DoubleAnimationUsingKeyFrames>

<DoubleAnimationUsingKeyFrames BeginTime="00:00:00" Storyboard.TargetName="circle0"

Storyboard.TargetProperty="(UIElement.RenderTransform).(TransformGroup.Children)[0].(ScaleTransform.ScaleY)">

<SplineDoubleKeyFrame KeySpline="0,0,0.601999998092651,0.400999993085861"

KeyTime="00:00:00.7000000" Value="0.3" />

</DoubleAnimationUsingKeyFrames>

<DoubleAnimationUsingKeyFrames BeginTime="00:00:00" Storyboard.TargetName="circle0"

Storyboard.TargetProperty="(UIElement.RenderTransform).(TransformGroup.Children)[0].(ScaleTransform.ScaleX)">

<SplineDoubleKeyFrame KeySpline="0,0,0.601999998092651,0.400999993085861"

KeyTime="00:00:00.7000000" Value="0.3" />

</DoubleAnimationUsingKeyFrames>

</Storyboard>

4. Add animation start and stop code

Add below code in your ProgressBar.xaml.cs file. This has a dependency property IsActive. When IsActive is set to true the Busy Indicator animation will start and when it is set to false the animation will be stopped.

public partial class ProgressBar : UserControl

{
   private Storyboard storyBoard;
   private List<Storyboard> storyBoardList;
   private int nextStoryBoard;
   public static readonly DependencyProperty IsActiveProperty =
   DependencyProperty.Register("IsActive", typeof(bool), typeof(ProgressBar), new PropertyMetadata(IsActivePropertyChanged));
   public ProgressBar()
   {
   InitializeComponent();
   this.storyBoard = new Storyboard()
   {
     Duration = new Duration(TimeSpan.FromMilliseconds(100))
   };
     this.storyBoard.Completed += new EventHandler(this.OnIntervalTimerCompleted);
     this.storyBoardList = new List<Storyboard>()
   {
     ProgressStoryboard0,
     ProgressStoryboard1,
     ProgressStoryboard2,
     ProgressStoryboard3,
     ProgressStoryboard4,
     ProgressStoryboard5,
     ProgressStoryboard6,
     ProgressStoryboard7,
     ProgressStoryboard8,
     ProgressStoryboard9
   };
   }
   public bool IsActive
   {
   get { return (bool)GetValue(IsActiveProperty); }
   set { SetValue(IsActiveProperty, value); }
   }
   private static void IsActivePropertyChanged(DependencyObject sender, DependencyPropertyChangedEventArgs e)
   {
        var spinControl = sender as ProgressBar;
   if (spinControl != null)
   {
   if ((bool)e.NewValue)
     {
         spinControl.Start();
   }
   else
   {
        spinControl.Stop();
   }
   }
   }
   private void Start()
   {
   this.Visibility = Visibility.Visible;
   StartAnimation.Begin();
   this.storyBoard.Begin();
   }
   private void Stop()
   {
   this.Visibility = Visibility.Collapsed;
   StartAnimation.Stop();
   this.nextStoryBoard = 0;
   this.storyBoard.Stop();
   foreach (var item in this.storyBoardList)
   {
   item.Stop();
   }
   }
   private void OnIntervalTimerCompleted(object sender, EventArgs e)
   {
        this.storyBoardList[nextStoryBoard].Begin();
   this.nextStoryBoard = this.nextStoryBoard > 8 ? 0 : this.nextStoryBoard + 1;
   this.storyBoard.Begin();
   }
}

At this point you have completed coding for BusyIndicator control. Now the next step is implementation to see how exactly it works.

5. Implementing Busy Indicator

To implement and test the above mentioned Busy Indicator, I have added a simple WCF MathService which returns sum of two values supplied to its Add method. The main reason behind choosing WCF service for this example is, this is the most common scenario to implement Busy Indicator. Add service reference of this service into Silverlight project.

MainPage.xaml changes:

Add namespace for Busy Indicator in MainPage.xaml file.

xmlns:progressBar="clr-namespace:CustomProgressBar"

And add below code in the same file.

</StackPanel>

</Grid>

<progressBar:ProgressBar x:Name="ProgressBar1" Visibility="Collapsed"/>

</Grid>

You can see in above code, I have placed custom Busy Indicator control in MainPage using below line of code.

<progressBar:ProgressBar x:Name="ProgressBar1" Visibility="Collapsed"/>

MainPage.xaml.cs change:

Add below code in this file.

private void btnAdd_Click(object sender, RoutedEventArgs e)

{

ProgressBar1.IsActive = true;

MathService.MathServiceClient proxy = new CustomProgressBar.MathService.MathServiceClient();

proxy.AddCompleted += new EventHandler<CustomProgressBar.MathService.AddCompletedEventArgs>(proxy_AddCompleted);

proxy.AddAsync(10, 10);

}

void proxy_AddCompleted(object sender, CustomProgressBar.MathService.AddCompletedEventArgs e)

{

lblResult.Text = e.Result.ToString();

ProgressBar1.IsActive = false;

}

Here I have added a button with the name "Add", on click of this button I am calling MathService to calculate sum of two given numbers. Once the result is returned from MathService it will be displayed in TextBlock. On button click event I am setting Progress Bar IsActive property to true, at this moment the Busy Indicator animation will start. And when the Add method completed event is called I am setting IsActive property value to false, to stop the animation.

6. Run the application

Once all the changes are completed run the application. You will see below screen when you click on "Add" button. The good thing is, until the Busy Indicator runs the UI portion of the application will be locked and once the processing is completed screen will be unlocked again.

To get and see the full source codes please download the source code for this application.

In this article we have seen steps to implement custom Busy Indicator.