uap:InitialRotationPreference (Windows 10)

Describes the orientations in which the app would prefer to be shown for the best user experience. On a device that can be rotated, such as a tablet, the app will not be redrawn for orientations that are not specified here. For instance, if the app specifies only Landscape and LandscapeFlipped orientations, and the device is rotated to a Portrait orientation, the app will not rotate.

Note that on devices that can't be rotated, an app might be shown in that device's default orientation and the app's preferred orientation will be ignored. However, on a device with a rotation lock activated, your app's preferred rotation will still be honored.

These orientation preference choices apply to both the splash screen and the app UI when a new session is launched for your app. The preferences can be changed during run time through the AutoRotationPreferences property.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <uap:VisualElements>

                   <uap:InitialRotationPreference>

Syntax

<uap:InitialRotationPreference>

  <!-- Child elements -->
  uap:Rotation{1,4}

</uap:InitialRotationPreference>

Key

{}   specific range of occurrences

Attributes and elements

Attributes

None.

Child elements

Child element Description
uap:Rotation Specifies a single rotational orientation in which an app will display.

Parent elements

Parent element Description
uap:VisualElements Describes the visual aspects of the app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 version 1511 (Build 10586)