Share via

SystemTray.SetOpacity Method

  • Article

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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)

Syntax

Public Shared Sub SetOpacity ( _
    element As DependencyObject, _
    opacity As Double _
)

public static void SetOpacity(
    DependencyObject element,
    double opacity
)

Parameters

Remarks

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.

Examples

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

Imports Microsoft.Phone.Shell

Partial Public Class MainPage
    Inherits PhoneApplicationPage

    Dim prog As ProgressIndicator
    
    Public Sub New()
        InitializeComponent()

        SystemTray.SetIsVisible(Me, true)
        SystemTray.SetOpacity(Me, 0.5)
        SystemTray.SetBackgroundColor(Me, Colors.Blue)
        SystemTray.SetForegroundColor(Me, Colors.Yellow)

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

        SystemTray.SetProgressIndicator(Me, prog)
    End Sub
End Class

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1

Platforms

Windows Phone

See Also

Reference

SystemTray Class

Microsoft.Phone.Shell Namespace

PhoneApplicationPage

Other Resources

Dependency Properties Overview

Attached Properties Overview