ViewSizePreference ViewSizePreference ViewSizePreference ViewSizePreference ViewSizePreference Enum

Definition

Defines the set of possible general window (app view) size preferences.

public : enum class ViewSizePreference
enum class winrt::Windows::UI::ViewManagement::ViewSizePreference : int32_t
public enum ViewSizePreference
Public Enum ViewSizePreference
var value = Windows.UI.ViewManagement.ViewSizePreference.custom;
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Fields

Custom Custom Custom Custom Custom

The window uses a custom preferred size specifed in the app.

Default Default Default Default Default

The app does not have a window size preference specified. Windows, rather than the app, sets the size preference, which defaults to UseHalf.

UseHalf UseHalf UseHalf UseHalf UseHalf

The window uses 50% (half) of the available horizontal screen pixels.

UseLess UseLess UseLess UseLess UseLess

The window uses less than 50% of the available horizontal screen pixels.

UseMinimum UseMinimum UseMinimum UseMinimum UseMinimum

The window uses the minimum horizontal pixel width (either 320 or 500 pixels) specifies in the app's manifest (such as package.appxmanifest).

UseMore UseMore UseMore UseMore UseMore

The window uses more than 50% of the available horizontal screen pixels.

UseNone UseNone UseNone UseNone UseNone

The window has no visible component.

Remarks

An "app view" is the displayed portion of a UWP app, and which can be variably sized by the user. A user's screen can have up to 4 app views of variable width displayed simultaneously, with a combined horizontal pixel width equal to that of the display device's horizontal resolution.

Custom view sizes

Set the ViewModePreferences.ViewSizePreference property value to Custom when you set the ViewModePreferences.CustomSize property.