SystemTray.Opacity Property

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

Gets or sets the opacity factor of the system tray on the current application page.

Namespace:  Microsoft.Phone.Shell
Assembly:  Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.

Syntax

Public Shared Property Opacity As Double
public static double Opacity { get; set; }
<object Opacity="double" .../>

Property Value

Type: System..::.Double
The opacity factor of the system tray on the current application page.

Exceptions

Exception Condition
InvalidOperationException

There is no active PhoneApplicationPage object.

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.

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

Other Resources

Dependency Properties Overview

Attached Properties Overview