screen_create_event()

Create an event that can later be filled with event data.

Synopsis:

#include <screen/screen.h>
 
int screen_create_event(screen_event_t *pev)

Since:

BlackBerry 10.0.0

Arguments:

pev

An address where the function can store a handle to the native event.

Library:

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

Description:

Function Type: Immediate Execution

This function creates an event object. This event can be used to store events from the process's event queue using screen_get_event(). Events are opaque handles. screen_get_event_property() functions must be used to get information from the event. You must destroy event objects when you no longer need them by using screen_destroy_event().

Returns:

0 if a new event was created, or -1 if an error occurred (errno is set).