uap:Rotation (Windows 10)
Specifies a single rotational orientation in which an app will display.
Element hierarchy
<uap:InitialRotationPreference>
<uap:Rotation>
Syntax
<uap:Rotation
Preference = 'A string that can have one of the following values: "portrait", "landscape", "portraitFlipped", or "landscapeFlipped".' />
Attributes and elements
Attributes
| Attribute | Description | Data type | Required | Default value |
|---|---|---|---|---|
| Preference | The specified orientation of the rotation. | A string that can have one of the following values: portrait, landscape, portraitFlipped, or landscapeFlipped. | Yes |
Child Elements
None.
Parent Elements
| Parent element | Description |
|---|---|
| uap:InitialRotationPreference | 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
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.
Remarks
To specify more than one preferred orientation, include multiple uap:Rotation elements in your uap:InitialRotationPreference element.
Requirements
| Item | Value |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| Minimum OS Version | Windows 10 version 1511 (Build 10586) |