navigator_event_get_app_state()

Get the app state from a NAVIGATOR_APP_STATE event.

Synopsis:

#include <bps/navigator.h>
 
BPS_API int navigator_event_get_app_state(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event

The NAVIGATOR_APP_STATE event.

Library:

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

Description:

This function can be called when a NAVIGATOR_APP_STATE event occurs. The result tells the caller which run partition the application is in (for the case of NAVIGATOR_APP_BACKGROUND, or NAVIGATOR_APP_FOREGROUND) or which partititon the application will be put into shortly (in the case of NAVIGATOR_APP_STOPPING).

Returns:

One of navigator_app_state_t, or BPS_FAILURE with errno set.