LauncherOptions.DesiredRemainingView | desiredRemainingView property

Applies to Windows only

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.

Syntax


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

Property value

Type: ViewSizePreference

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

Remarks

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.

Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Minimum supported phone

None supported

Namespace

Windows.System
Windows::System [C++]

Metadata

Windows.winmd

See also

LauncherOptions
ViewSizePreference

 

 

Show:
© 2014 Microsoft