Skip to content

Latest commit

 

History

History
135 lines (108 loc) · 3.45 KB

File metadata and controls

135 lines (108 loc) · 3.45 KB
description Search.Product title ms.assetid keywords ms.topic ms.date
Specifies a single rotational orientation in which an app will display (Windows 8).
eADQiWindows 10XVcnh
Rotation (Windows 8 package schema)
0e351d87-2ff0-4e9e-b3ea-6a6254d4c1c4
windows 10, uwp, schema, package manifest
reference
04/05/2017

Rotation (package schema for Windows 8)

Specifies a single rotational orientation in which an app will display.

Element hierarchy

<Package>
<Applications>
<Application>
<VisualElements>
<InitialRotationPreference>
<Rotation>

Syntax

<Rotation Preference = "portrait" | "landscape" | "portraitFlipped" | "landscapeFlipped" />

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
Preference

The rotational orientation.

This attribute can have one of the following values:

  • portrait
  • landscape
  • portraitFlipped
  • landscapeFlipped
Yes

 

Child Elements

None.

Parent Elements

Parent Element Description
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 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](element-splashscreen.md) and the app UI when a new session is launched for your app. The preferences can be changed during run time through the [AutoRotationPreferences](/uwp/api/Windows.Graphics.Display.DisplayProperties) property.

 

Remarks

To specify more than one preferred orientation, include multiple Rotation elements in your InitialRotationPreference element.

Requirements

Value
Namespace http://schemas.microsoft.com/appx/2010/manifest