Windows.UI.ViewManagement.ApplicationView

June 17, 2020 ยท View on GitHub

-description

Represents the active application view and associated states and behaviors.

-remarks

A window (also called an app view) is the displayed portion of a Windows Runtime app. On Windows, a user's screen can have up to 4 windows of variable width displayed simultaneously. They do not overlap, and their top and bottom edges touch the top and bottom edges of the screen. There may be non-window areas between adjacent windows.

The window is not the same thing as the current page of the application. It is better thought of as the container of the pages; you can use the window reference in your program for all the pages of the application.

Each window has a corresponding CoreWindow that represents the UI processing thread (including the core input handlers and event dispatcher) for the window.

You can use the properties (or methods, for JavaScript) of the window in configuring your pages. For example: the Orientation property tells you whether the window is portrait or landscape; for Windows the AdjacentToLeftDisplayEdge property tells you whether the left edge of the screen is the left border of the window; and the isFullScreen method tells you whether the window uses the entire screen. For examples of using these methods, see the Application Views sample.

To obtain an object of this type, call ApplicationView.GetForCurrentView.

Note

Do not use the value returned in the ApplicationView.Value property when creating a page layout. This method is deprecated and may not be available in future releases.

Version history

Windows versionSDK versionValue added
170315063IsViewModeSupported
170315063TryConsolidateAsync
170315063TryEnterViewModeAsync(ApplicationViewMode)
170315063TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
170315063ViewMode
190318362ClearAllPersistedState
190318362ClearPersistedState
190318362GetDisplayRegions
190318362PersistedStateId
190318362UIContext
190318362WindowingEnvironment

-examples

-see-also

Disabling screen capture sample (Windows 10), User interaction mode sample (Windows 10), Multiple views sample (Windows 10), Full screen mode sample (Windows 10), Window resizing sample (Windows 10), Title bar sample (Windows 10)