×
Namespaces

Variants
Actions
(Difference between revisions)

Custom splash screen with progress bar for Windows Phone applications

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot fixing redirect link.)
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot update - Fix metadata etc)
Line 2: Line 2:
 
{{Abstract|This article demonstrates how to create a splash screen with an animated progress bar.}}
 
{{Abstract|This article demonstrates how to create a splash screen with an animated progress bar.}}
 
    
 
    
{{ArticleMetaData
+
{{ArticleMetaData <!-- v1.2 -->
|sourcecode= [[Media: SplashBar.zip]]<!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
+
|sourcecode= [[Media:SplashBar.zip]]  
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|devices= WP7 Emulator <!-- Devices tested against - e.g. ''devices=N95, N8'') -->
 
|devices= WP7 Emulator <!-- Devices tested against - e.g. ''devices=N95, N8'') -->
Line 9: Line 9:
 
|platform= Windows Phone 7.1<!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|platform= Windows Phone 7.1<!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
+
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
|capabilities=<!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
+
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 
|keywords= Splash Screen/ Progress Bar<!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 
|keywords= Splash Screen/ Progress Bar<!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
|id= <!-- Article Id (Knowledge base articles only) -->
+
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 
|creationdate= 04th October,2011<!-- Format YYYYMMDD -->
 
|creationdate= 04th October,2011<!-- Format YYYYMMDD -->
|author= [[User:somnathbanik]] <!-- Display as link [[User:username]] -->
+
|author= [[User:Somnathbanik]]
 
}}
 
}}
  
  
 
==Introduction==
 
==Introduction==
The default  '''SplashScreenImage.jpg'''  in windows phone 7 application is a static image. In this article we will add an animated progress bar in the splash screen.
+
The default  '''SplashScreenImage.jpg'''  in windows phone 7 application is a static image. In this article we will add an animated progress bar in the splash screen.
 
   
 
   
 
   
 
   
Line 26: Line 34:
 
   
 
   
 
==Basic Idea==  
 
==Basic Idea==  
Here we will use some tips and tricks to add the progress bar in the splash screen. As we know that the default splash screen is '''SplashScreenImage.jpg''' and loads when the app starts. We use the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class to displays content on top of existing content. In our case the existing content is the default splash screen, so we will add the same splash screen and the progress bar in the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class so that the user doesn’t have the feel of image change. And thus the user will see the splash screen with an animated progress bar. The [http://msdn.microsoft.com/en-us/library/system.componentmodel.backgroundworker.aspx BackgroundWorker] class is used to run an operation in a separate thread, so that when it expires we close the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class.
+
Here we will use some tips and tricks to add the progress bar in the splash screen. As we know that the default splash screen is '''SplashScreenImage.jpg''' and loads when the app starts. We use the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class to displays content on top of existing content. In our case the existing content is the default splash screen, so we will add the same splash screen and the progress bar in the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class so that the user doesn’t have the feel of image change. And thus the user will see the splash screen with an animated progress bar. The [http://msdn.microsoft.com/en-us/library/system.componentmodel.backgroundworker.aspx BackgroundWorker] class is used to run an operation in a separate thread, so that when it expires we close the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class.
  
  
 
==Implementation==
 
==Implementation==
 
   
 
   
First lets create a project with ''Windows Phone Application'' Template. Once the project is being created, lets create a ''Windows Phone User Control'' '''SplashScreenControl.xaml''' and add  {{Icode|ProgressBar}}, {{Icode|TextBlock}} and {{Icode|Image}} in it.  The image is the default splash of the project.  
+
First lets create a project with ''Windows Phone Application'' Template. Once the project is being created, lets create a ''Windows Phone User Control'' '''SplashScreenControl.xaml''' and add  {{Icode|ProgressBar}}, {{Icode|TextBlock}} and {{Icode|Image}} in it.  The image is the default splash of the project.  
 
<code cpp>
 
<code cpp>
 
<Grid x:Name="LayoutRoot" Background="White" Width="480" Height="800">             
 
<Grid x:Name="LayoutRoot" Background="White" Width="480" Height="800">             
Line 54: Line 62:
 
   
 
   
 
</code>
 
</code>
First we initialize the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class and then set {{Icode|SplashScreenControl}} class to be hosted in the popup. {{Icode|IsOpen}} opens the popup. Till now the code will load the splash screen (popup) with the progress bar.  
+
First we initialize the [http://msdn.microsoft.com/en-us/library/system.windows.controls.primitives.popup%28v=VS.95%29.aspx Popup] class and then set {{Icode|SplashScreenControl}} class to be hosted in the popup. {{Icode|IsOpen}} opens the popup. Till now the code will load the splash screen (popup) with the progress bar.  
Now we will add some background process,  and when the background process gets completed we will close the popup as a result user will see the splash screen.  
+
Now we will add some background process,  and when the background process gets completed we will close the popup as a result user will see the splash screen.  
 
Function {{Icode|StartLoadingData()}} starts and complete the background work.
 
Function {{Icode|StartLoadingData()}} starts and complete the background work.
 
   
 
   
Line 105: Line 113:
 
==Source Code==
 
==Source Code==
 
The full source code of the example is available here: [[File: SplashBar.zip]]
 
The full source code of the example is available here: [[File: SplashBar.zip]]
 +
[[Category:Code Examples]]

Revision as of 03:21, 24 April 2012

This article demonstrates how to create a splash screen with an animated progress bar.

WP Metro Icon UI.png
SignpostIcon XAML 40.png
WP Metro Icon WP8.png
SignpostIcon WP7 70px.png
Article Metadata
Code Example
Source file: Media:SplashBar.zip
Tested with
Devices(s): WP7 Emulator
Compatibility
Platform(s): Windows Phone 7.1
Windows Phone 8
Windows Phone 7.5
Article
Keywords: Splash Screen/ Progress Bar
Created: somnathbanik (04 Oct 2014)
Last edited: hamishwillee (24 Apr 2012)


Contents

Introduction

The default SplashScreenImage.jpg in windows phone 7 application is a static image. In this article we will add an animated progress bar in the splash screen.


Splash Screen

Basic Idea

Here we will use some tips and tricks to add the progress bar in the splash screen. As we know that the default splash screen is SplashScreenImage.jpg and loads when the app starts. We use the Popup class to displays content on top of existing content. In our case the existing content is the default splash screen, so we will add the same splash screen and the progress bar in the Popup class so that the user doesn’t have the feel of image change. And thus the user will see the splash screen with an animated progress bar. The BackgroundWorker class is used to run an operation in a separate thread, so that when it expires we close the Popup class.


Implementation

First lets create a project with Windows Phone Application Template. Once the project is being created, lets create a Windows Phone User Control SplashScreenControl.xaml and add ProgressBar, TextBlock and Image in it. The image is the default splash of the project.

<Grid x:Name="LayoutRoot" Background="White" Width="480" Height="800">            
<ProgressBar HorizontalAlignment="Left" Margin="47,692,0,89" Name="progressBar1" Width="383" />
<Image Height="512" HorizontalAlignment="Left" Margin="0,0,0,0" Name="image1" Stretch="Fill" VerticalAlignment="Top" Width="480" Source="SplashScreenImage.jpg" />
<TextBlock HorizontalAlignment="Left" Margin="185,656,0,114" Name="textBlock1" Text="Please Wait..." Width="111" Foreground="Black" FontSize="22" />
</Grid>

In MainPage.xaml.cs Constructor we called a function ShowSplash() to load the popup.

private void ShowSplash()
{
this.popup = new Popup();
this.popup.Child = new SplashScreenControl();
this.popup.IsOpen = true;
StartLoadingData();
}

First we initialize the Popup class and then set SplashScreenControl class to be hosted in the popup. IsOpen opens the popup. Till now the code will load the splash screen (popup) with the progress bar. Now we will add some background process, and when the background process gets completed we will close the popup as a result user will see the splash screen. Function StartLoadingData() starts and complete the background work.


private void StartLoadingData()
{
backroungWorker = new BackgroundWorker();
backroungWorker.DoWork += new DoWorkEventHandler(backroungWorker_DoWork);
backroungWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(backroungWorker_RunWorkerCompleted);
backroungWorker.RunWorkerAsync();
}

First we initialize the BackgroundWorker class. We called RunWorkerAsync() function to starts execution of a background operation and thus backroungWorker_DoWork() is called.

 
void backroungWorker_DoWork(object sender, DoWorkEventArgs e)
{
//here we can load data
Thread.Sleep(9000);
}

Here we use the Sleep() function to wait for some time. When backroungWorker_DoWork() gets expired, backroungWorker_RunWorkerCompleted() is called which closes the popup.

 
void backroungWorker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
this.Dispatcher.BeginInvoke(() =>
{
this.popup.IsOpen = false;
 
}
);
}

Thus user can see a splash screen with the progress bar. To make a continuous progress bar we add the below code in SplashScreenControl.xaml.cs

 
this.progressBar1.IsIndeterminate = true;

Source Code

The full source code of the example is available here: File:SplashBar.zip

790 page views in the last 30 days.
×