navigator_done_orientation_id()

#include <bps/navigator.h>
 

BPS_API int navigator_done_orientation_id(const char *id)

Since:

BlackBerry 10.0.0

Arguments:

id

The ID, as retrieved from the original NAVIGATOR_ORIENTATION event using navigator_event_get_id().

Library:

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

Description:

The navigator_done_orientation_id() function indicates to the navigator that your application is finished rotating. After receiving a NAVIGATOR_ORIENTATION event, and after your application has resized its screen, this function lets the navigator know that you are finished your rotation.

This function provides an alternative to the navigator_done_orientation() function, which requires the NAVIGATOR_ORIENTATION event to be passed in. In the case where the NAVIGATOR_ORIENTATION event will no longer be available to be passed in, the id can be retrieved from it, stored, and used in this function.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.