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. Educate yourself

The Documentation tab contains tons of examples, tutorials, and best practices to guide you along the path towards building an awesome app.

The documentation for your preferred focus always appears at the top of the left-hand navigation, but you can still access the rest of the documentation at the bottom.

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