screen_request_events()

#include <bps/screen.h>
 

BPS_API int screen_request_events(screen_context_t context)

Since:

BlackBerry 10.0.0

Arguments:

context

The libscreen context to use for event retrieval.

Library:

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

Description:

The screen_request_events() function starts to deliver libscreen events to an application using BPS. An application must not invoke libscreen's screen_get_event() function if it is receiving screen events through BPS. The screen_request_events() function should not be called multiple times before calling screen_stop_events(). An application may only request events for a single screen_context_t at one time, and only for a single thread.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.