Legacy Documentation: Version 4.3.0
DeviceOrientation
Description

Describes physical orientation of the device as determined by the OS.

If device is physically situated between discrete positions, as when (for example) rotated diagonally, system will report Unknown orientation.
Variables
Unknown The orientation of the device cannot be determined.
Portrait The device is in portrait mode, with the device held upright and the home button at the bottom.
PortraitUpsideDown The device is in portrait mode but upside down, with the device held upright and the home button at the top.
LandscapeLeft The device is in landscape mode, with the device held upright and the home button on the right side.
LandscapeRight The device is in landscape mode, with the device held upright and the home button on the left side.
FaceUp The device is held parallel to the ground with the screen facing upwards.
FaceDown The device is held parallel to the ground with the screen facing downwards.