SystemTray.SetOpacity Method

July 28, 2014

Sets the value of the Opacity attached property for a specified phone application page.

Namespace:  Microsoft.Phone.Shell
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)

public static void SetOpacity(
	DependencyObject element,
	double opacity
)

Parameters

element
Type: System.Windows.DependencyObject
The page for which to set the Opacity attached property.
opacity
Type: System.Double
The opacity factor to set for the system tray.

Expected values are between 0.0 and 1.0. The opacity of the system tray can be adjusted finely, but we recommend that you use only values of 0.0, 0.5, and 1.0.

  • 0.0 The system tray is completely transparent. The system tray is laid over the contents of the page, which show through. The page is not resized.

  • 0.5 The system tray is partially transparent. The system tray is laid over the contents of the page, which show through. The page is not resized.

  • 1.0 The system tray is completely opaque. The system tray covers the current page. The page is resized to the area of the screen not occupied by the system tray.

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

The following code example shows how to use the SystemTray class in conjunction with the ProgressIndicator class.

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);
        }
    }
}

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Windows Phone

Show:
© 2014 Microsoft