Share via


LauncherOptions.DesiredRemainingView Property

Definition

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.

public:
 property ViewSizePreference DesiredRemainingView { ViewSizePreference get(); void set(ViewSizePreference value); };
ViewSizePreference DesiredRemainingView();

void DesiredRemainingView(ViewSizePreference value);
public ViewSizePreference DesiredRemainingView { get; set; }
var viewSizePreference = launcherOptions.desiredRemainingView;
launcherOptions.desiredRemainingView = viewSizePreference;
Public Property DesiredRemainingView As ViewSizePreference

Property Value

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

Implements

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.

Important

This property is only implemented on Desktop devices.

Applies to

See also