DeviceOrientation

Since: BlackBerry 10.0.0

#include <bb/device/DeviceOrientation>

Represents the orientation in which the device is being held relative to the BlackBerry logo in its natural orientation.

The natural orientation of the device is DeviceDirection::North (0 degrees).

Note:

It is not appropriate to use this information for responding to device orientation in your UI. This value will change regardless of how the UI responds. For UI orientation see bb::cascades::OrientationSupport.

Overview

Public Types Index

enum Type

FaceUp 0, FaceDown 1, TopUp 2, LeftUp 3, RightUp 4, BottomUp 5

Public Types

Type

The orientation in which the device is currently being held relative to the BlackBerry logo in its natural orientation.

Since:

BlackBerry 10.0.0

FaceUp 0: Device is lying flat on a horizontal surface, such as a desk, with the display visible.
FaceDown 1: Device is lying flat on a horizontal surface, such as a desk, with the display obscured.

Since:
BlackBerry 10.0.0
TopUp 2: BlackBerry logo is upright.

Since:
BlackBerry 10.0.0
LeftUp 3: BlackBerry logo is sideways - text runs downwards, display rotated 270 degrees to the left.

Since:
BlackBerry 10.0.0
RightUp 4: BlackBerry logo is sideways - text runs upwards, display rotated 90 degrees to the left.

Since:
BlackBerry 10.0.0
BottomUp 5: BlackBerry logo is upside down, display rotated upside down.

Since:
BlackBerry 10.0.0

4. Start developing

The Reference tab is where you'll find essential details about how to use our APIs.

You can use the left-hand navigation to choose how you would like to browse the reference: by module, by topic, or alphabetically. If you have an idea of what you are looking for, start typing it in the Filter box.