DesiredRemainingView | desiredRemainingView property

LauncherOptions.DesiredRemainingView | desiredRemainingView property

Launch a target app and have the currently running source app remain on the screen by sharing the space equally with the target app or by taking up more or less space than the target app.


var desiredRemainingView = launcherOptions.desiredRemainingView;
launcherOptions.desiredRemainingView = desiredRemainingView;

Property value

Type: ViewSizePreference

A ViewSizePreference-typed value that specifies the app’s desired view size.


Source apps that call LaunchUriAsync or LaunchFileAsync can request that they remain on screen after a URI or file launch. By default, Windows will attempt to share all available space equally between the source app and the target app that handles the URI or file. Source apps can use the DesiredRemainingView property to indicate to the system that they prefer their app window to take up more or less of the available space. DesiredRemainingView can also be used to indicate that the source app does not need to remain on screen after the file or URI launch and can be completely replaced by the target app. This property only specifies the preferred window size of the calling app. It doesn't specify the behavior of other apps that may happen to also be on screen at the same time.

Note  Windows takes into account multiple different factors when determining the source app's final window size, for example, the preference of the source app, the number of apps on screen, the screen orientation, and so on. By setting DesiredRemainingView, you aren't guaranteed a specific windowing behavior for the source app.
Important  This property is only implemented on Desktop devices.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0


Windows::System [C++]



Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Minimum supported phone

None supported


Windows::System [C++]



See also

Association launching sample (Windows 10)



© 2016 Microsoft