Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 3 rated this helpful - Rate this topic

ProgressIndicator Class

Windows Phone

March 22, 2012

Provides methods and properties for interacting with the progress indicator on the system tray on an application page.

System.Object
  System.Windows.DependencyObject
    Microsoft.Phone.Shell.ProgressIndicator

Namespace:  Microsoft.Phone.Shell
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.
C#
VB
Copy 
public class ProgressIndicator : DependencyObject
XAML Object Element Usage
Copy 
<ProgressIndicator .../>

The ProgressIndicator type exposes the following members.

  Name Description
Public method ProgressIndicator Creates a new instance of the ProgressIndicator class.
Top
  Name Description
Public property Dispatcher (Inherited from DependencyObject.)
Public property IsIndeterminate Gets or sets a value that indicates whether the progress indicator on the system tray on the current application page is determinate or indeterminate.
Public property IsVisible Gets or sets the visibility of the progress indicator on the system tray on the current application page.
Public property Text Gets or sets the text of the progress indicator on the system tray on the current application page.
Public property Value Gets or sets the value of the progress indicator on the system tray on the current application page.
Top
  Name Description
Public method CheckAccess (Inherited from DependencyObject.)
Public method ClearValue (Inherited from DependencyObject.)
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetAnimationBaseValue (Inherited from DependencyObject.)
Public method GetHashCode (Inherited from Object.)
Public method GetType (Inherited from Object.)
Public method GetValue (Inherited from DependencyObject.)
Protected method MemberwiseClone (Inherited from Object.)
Public method ReadLocalValue (Inherited from DependencyObject.)
Public method SetValue (Inherited from DependencyObject.)
Public method ToString (Inherited from Object.)
Top
  Name Description
Public field Static member IsIndeterminateProperty The dependency property for IsIndeterminate.
Public field Static member IsVisibleProperty The dependency property for IsVisible.
Public field Static member TextProperty The dependency property for Text.
Public field Static member ValueProperty The dependency property for Value.
Top

The system tray is also referred to as the status bar.

The following code example shows how to use the ProgressIndicator class.

C#
VB
Copy 
using Microsoft.Phone.Shell;

namespace SystemTrayTest
{
    public partial class MainPage : PhoneApplicationPage
    {
        ProgressIndicator prog;

        public MainPage()
        {
            InitializeComponent();

            SystemTray.SetIsVisible(this, true);
            SystemTray.SetOpacity(this, 0.5);
            SystemTray.SetBackgroundColor(this, Colors.Purple);
            SystemTray.SetForegroundColor(this, Colors.Yellow);

            prog = new ProgressIndicator();
            prog.IsVisible = true;
            prog.IsIndeterminate = true;
            prog.Text = "Click me...";

            SystemTray.SetProgressIndicator(this, prog);
        }
    }
}

The following code example shows how to use the ProgressIndicator on the SystemTray from XAML. This code goes inside your PHONE:PHONEAPPLICATIONPAGE element. Note that the IsIndeterminate, IsVisible, Text, and Value attributes can all be data-bound.

XAML
Copy 
<shell:SystemTray.ProgressIndicator>
    <shell:ProgressIndicator IsIndeterminate="True" IsVisible="True" Text="Click me..." />
</shell:SystemTray.ProgressIndicator>

Windows Phone OS

Supported in: 7.1

Windows Phone

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Did you find this helpful?
(1500 characters remaining)