ApplicationView.SuppressSystemOverlays | suppressSystemOverlays property

Applies to Windows Phone only

Gets or sets a value indicating whether or not system overlays (such as overlay applications or the soft steering wheel) should be shown.

Syntax


var suppressSystemOverlays = applicationView.suppressSystemOverlays;
applicationView.suppressSystemOverlays = suppressSystemOverlays;

Property value

Type: Boolean [JavaScript] | System.Boolean [.NET] | Platform::Boolean [C++]

true if system overlays (such as overlay applications or the soft steering wheel) should be shown; otherwise false.

Remarks

You can set your app to "full-screen" by setting this property to true. A full-screen app, such as a game, is not occluded by overlay apps. An overlay app is one that shows its UI in the Overlay Layer, which is positioned in a layer above the app and lock layers, but below certain other chrome elements (such as the SIP). An example of an overlay app is an instant messaging app that displays a UI that overlays the app below.

In addition, by setting SuppressSystemOverlays to true, accidental taps of the Search button are far less likely to affect the app. When SuppressSystemOverlays is set to true, the user must tap the Search button twice in close succession to actuate the Search experience, which overlays the running app. We recommend using this property to opt into this behavior only in these cases: user feedback shows that accidental taps of the Search button are likely based on the layout of your app; if your app shows full-screen media content; or if your app uses camera functionality or the viewfinder.

SuppressSystemOverlays is true by default for an app associated with the Games category, and false by default for an application associated with any other category.

Requirements

Minimum supported client

None supported

Minimum supported server

None supported

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.ViewManagement
Windows::UI::ViewManagement [C++]

Metadata

Windows.winmd

See also

ApplicationView

 

 

Show:
© 2014 Microsoft