DeviceOrientation Manual     Reference     Scripting  
Scripting > Enumerations > DeviceOrientation
DeviceOrientation Enumeration

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.

Values
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.