navigator_set_orientation()

Set the orientation in the navigator based on angle.

Synopsis:

#include <bps/navigator.h>

BPS_API int navigator_set_orientation(int angle,
                                      char **id)

BlackBerry 10.0.0

angle: The angle of the orientation to set: NAVIGATOR_TOP_UP, NAVIGATOR_RIGHT_UP, NAVIGATOR_LEFT_UP, NAVIGATOR_BOTTOM_UP.

id: If not null, the ID used in the orientation request will be returned in id. The caller must free this buffer using bps_free().

libbps (For the qcc command, use the -l bps option to link against this library)

The navigator_set_orientation() function sends a navigator orientation request to set the orientation in the navigator.

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.