ApplicationView ApplicationView ApplicationView ApplicationView ApplicationView Class

Definition

Represents the active application view and associated states and behaviors.

public : sealed class ApplicationView : IApplicationView, IApplicationView2, IApplicationView3, IApplicationView4
struct winrt::Windows::UI::ViewManagement::ApplicationView : IApplicationView, IApplicationView2, IApplicationView3, IApplicationView4
public sealed class ApplicationView : IApplicationView, IApplicationView2, IApplicationView3, IApplicationView4
Public NotInheritable Class ApplicationView Implements IApplicationView, IApplicationView2, IApplicationView3, IApplicationView4
// This class does not provide a public constructor.
Attributes

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

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 Value ApplicationView.Value property when creating a page layout. This method is deprecated and may not be available in future releases.

Properties

AdjacentToLeftDisplayEdge AdjacentToLeftDisplayEdge AdjacentToLeftDisplayEdge AdjacentToLeftDisplayEdge AdjacentToLeftDisplayEdge

Gets a value that indicates whether the current window is in close proximity to the left edge of the screen.

AdjacentToRightDisplayEdge AdjacentToRightDisplayEdge AdjacentToRightDisplayEdge AdjacentToRightDisplayEdge AdjacentToRightDisplayEdge

Gets a value that indicates whether the current window is in close proximity to the right edge of the screen.

DesiredBoundsMode DesiredBoundsMode DesiredBoundsMode DesiredBoundsMode DesiredBoundsMode

Gets a value that indicates the bounds used by the framework to lay out the contents of the window (app view).

FullScreenSystemOverlayMode FullScreenSystemOverlayMode FullScreenSystemOverlayMode FullScreenSystemOverlayMode FullScreenSystemOverlayMode

Gets or sets a value that indicates how an app in full-screen mode responds to edge swipe actions.

Id Id Id Id Id

Gets the ID of the window (app view).

IsFullScreen IsFullScreen IsFullScreen IsFullScreen IsFullScreen

Note

IsFullScreen may be altered or unavailable for releases after Windows 10. Instead, use IsFullScreenMode.

Gets a value that indicates whether the window touches both the left and right sides of the display.

IsFullScreenMode IsFullScreenMode IsFullScreenMode IsFullScreenMode IsFullScreenMode

Gets a value that indicates whether the app is running in full-screen mode.

IsOnLockScreen IsOnLockScreen IsOnLockScreen IsOnLockScreen IsOnLockScreen

Gets whether the window (app view) is on the Windows lock screen.

IsScreenCaptureEnabled IsScreenCaptureEnabled IsScreenCaptureEnabled IsScreenCaptureEnabled IsScreenCaptureEnabled

Gets or sets whether screen capture is enabled for the window (app view).

Orientation Orientation Orientation Orientation Orientation

Gets the current orientation (landscape or portrait) of the window (app view) with respect to the display.

PreferredLaunchViewSize PreferredLaunchViewSize PreferredLaunchViewSize PreferredLaunchViewSize PreferredLaunchViewSize

Gets or sets the size that the app launches with when the ApplicationView.PreferredLaunchWindowingMode property is set to PreferredLaunchViewSize, except in cases where the system manages the window size directly.

PreferredLaunchWindowingMode PreferredLaunchWindowingMode PreferredLaunchWindowingMode PreferredLaunchWindowingMode PreferredLaunchWindowingMode

Gets or sets a value that indicates the windowing mode the app launches with.

SuppressSystemOverlays SuppressSystemOverlays SuppressSystemOverlays SuppressSystemOverlays SuppressSystemOverlays

Note

SuppressSystemOverlays may be altered or unavailable for releases after Windows 10. Instead, use TryEnterFullScreenMode and FullScreenSystemOverlayMode.

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

TerminateAppOnFinalViewClose TerminateAppOnFinalViewClose TerminateAppOnFinalViewClose TerminateAppOnFinalViewClose TerminateAppOnFinalViewClose

Indicates whether the app terminates when the last window is closed.

Title Title Title Title Title

Gets or sets the displayed title of the window.

TitleBar TitleBar TitleBar TitleBar TitleBar

Gets the title bar of the app.

Value Value Value Value Value

Note

ApplicationView static methods may be altered or unavailable for releases after Windows 8.1. Instead, use ApplicationView.GetForCurrentView to get an ApplicationView object.

Gets the state of the current window (app view).

ViewMode ViewMode ViewMode ViewMode ViewMode

Gets the app view mode for the current view.

VisibleBounds VisibleBounds VisibleBounds VisibleBounds VisibleBounds

Gets the visible region of the window (app view). The visible region is the region not occluded by chrome such as the status bar and app bar.

Methods

ExitFullScreenMode() ExitFullScreenMode() ExitFullScreenMode() ExitFullScreenMode() ExitFullScreenMode()

Takes the app out of full-screen mode.

GetApplicationViewIdForWindow(ICoreWindow) GetApplicationViewIdForWindow(ICoreWindow) GetApplicationViewIdForWindow(ICoreWindow) GetApplicationViewIdForWindow(ICoreWindow) GetApplicationViewIdForWindow(ICoreWindow)

Gets the window ID that corresponds to a specific CoreWindow managed by the app.

GetForCurrentView() GetForCurrentView() GetForCurrentView() GetForCurrentView() GetForCurrentView()

Gets the view state and behavior settings of the active application.

IsViewModeSupported(ApplicationViewMode) IsViewModeSupported(ApplicationViewMode) IsViewModeSupported(ApplicationViewMode) IsViewModeSupported(ApplicationViewMode) IsViewModeSupported(ApplicationViewMode)

Determines whether the specified view mode is supported on the current device.

SetDesiredBoundsMode(ApplicationViewBoundsMode) SetDesiredBoundsMode(ApplicationViewBoundsMode) SetDesiredBoundsMode(ApplicationViewBoundsMode) SetDesiredBoundsMode(ApplicationViewBoundsMode) SetDesiredBoundsMode(ApplicationViewBoundsMode)

Sets a value indicating the bounds used by the framework to lay out the contents of the window (app view).

SetPreferredMinSize(Size) SetPreferredMinSize(Size) SetPreferredMinSize(Size) SetPreferredMinSize(Size) SetPreferredMinSize(Size)

Sets the smallest size, in effective pixels, allowed for the app window.

ShowStandardSystemOverlays() ShowStandardSystemOverlays() ShowStandardSystemOverlays() ShowStandardSystemOverlays() ShowStandardSystemOverlays()

Shows system UI elements, like the title bar, over a full-screen app.

TryConsolidateAsync() TryConsolidateAsync() TryConsolidateAsync() TryConsolidateAsync() TryConsolidateAsync()

Tries to close the current app view. This method is a programmatic equivalent to a user initiating a close gesture for the app view.

TryEnterFullScreenMode() TryEnterFullScreenMode() TryEnterFullScreenMode() TryEnterFullScreenMode() TryEnterFullScreenMode()

Attempts to place the app in full-screen mode.

TryEnterViewModeAsync(ApplicationViewMode) TryEnterViewModeAsync(ApplicationViewMode) TryEnterViewModeAsync(ApplicationViewMode) TryEnterViewModeAsync(ApplicationViewMode) TryEnterViewModeAsync(ApplicationViewMode)

Attempts to change the app view to the specified view mode.

TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)

Attempts to change the app view to the specified view mode using the specified options.

TryResizeView(Size) TryResizeView(Size) TryResizeView(Size) TryResizeView(Size) TryResizeView(Size)

Attempts to change the size of the view to the specified size in effective pixels.

TryUnsnap() TryUnsnap() TryUnsnap() TryUnsnap() TryUnsnap()

Note

TryUnsnap may be altered or unavailable for releases after Windows 8.1. Apps can be continuously resized, but cannot be snapped, starting in Windows 8.1. Also, ApplicationView static methods may be altered or unavailable for releases after Windows 8.1. Use ApplicationView.GetForCurrentView to get an ApplicationView object.

Attempts to unsnap a previously snapped app. This call will only succeed when the app is running in the foreground.

TryUnsnapToFullscreen() TryUnsnapToFullscreen() TryUnsnapToFullscreen() TryUnsnapToFullscreen() TryUnsnapToFullscreen()

Attempts to unsnap a previously snapped app.

Events

Consolidated Consolidated Consolidated Consolidated Consolidated

Occurs when the window is removed from the list of recently used apps, or if the user executes a close gesture on it.

VisibleBoundsChanged VisibleBoundsChanged VisibleBoundsChanged VisibleBoundsChanged VisibleBoundsChanged

This event is raised when the value of VisibleBounds changes, typically as a result of the status bar, app bar, or other chrome being shown or hidden.

See Also