DisplayOrientations Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Describes the orientation of a rectangular monitor.
This enumeration supports a bitwise combination of its member values.
public enum class DisplayOrientations/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DisplayOrientations[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DisplayOrientationsvar value = Windows.Graphics.Display.DisplayOrientations.nonePublic Enum DisplayOrientations- Inheritance
-
DisplayOrientations
- Attributes
Windows requirements
| Device family |
Windows 10 (introduced in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
Fields
| Name | Value | Description |
|---|---|---|
| None | 0 | No display orientation is specified. |
| Landscape | 1 | Specifies that the monitor is oriented in landscape mode where the width of the display viewing area is greater than the height. |
| Portrait | 2 | Specifies that the monitor rotated 90 degrees in the clockwise direction to orient the display in portrait mode where the height of the display viewing area is greater than the width. |
| LandscapeFlipped | 4 | Specifies that the monitor rotated another 90 degrees in the clockwise direction (to equal 180 degrees) to orient the display in landscape mode where the width of the display viewing area is greater than the height. This landscape mode is flipped 180 degrees from the Landscape mode. |
| PortraitFlipped | 8 | Specifies that the monitor rotated another 90 degrees in the clockwise direction (to equal 270 degrees) to orient the display in portrait mode where the height of the display viewing area is greater than the width. This portrait mode is flipped 180 degrees from the Portrait mode. |
Remarks
Display orientation expresses the angle at which a monitor rotated in the clockwise direction to show a straight picture. For example, if the operating system reports orientation as 90 degrees, the user rotated the monitor 90 degrees clockwise to show a straight picture; if the user returns the monitor to its original position, the operating system reports orientation as 90 degrees counterclockwise. Applications typically use this property to translate the reading of an accelerometer or to translate the physical button events in accordance with the current screen rotation.
A device that is first oriented in landscape mode has the following angles of rotation:
- Landscape = 0 degrees
- Portrait = 90 degrees
- LandscapeFlipped = 180 degrees
- PortraitFlipped = 270 degrees
A device that is first oriented in portrait mode has the following angles of rotation:
- Portrait = 0 degrees
- LandscapeFlipped = 90 degrees
- PortraitFlipped = 180 degrees
- Landscape = 270 degrees
The Scaling according to DPI sample shows how to use the DisplayOrientations enumeration.
The DisplayOrientations values describe the orientation of the display or monitor and not necessarily the orientation of your app. To determine the orientation of your app for layout purposes, use the ApplicationView.Orientation property.