navigator_invoke_select_list_item()

Request that the list item specified by selection is invoked to replace the current list item that this application belongs to.

Synopsis:

#include <bps/navigator_invoke.h>
 
BPS_API int navigator_invoke_select_list_item(navigator_invoke_list_cursor_direction_t selection)

Since:

BlackBerry 10.2.0

Arguments:

selection

The list item to invoke. This is either NAVIGATOR_INVOKE_LIST_CURSOR_DIRECTION_NEXT to invoke the next list item or NAVIGATOR_INVOKE_LIST_CURSOR_DIRECTION_PREVIOUS to invoke the previous list item. NAVIGATOR_INVOKE_LIST_CURSOR_DIRECTION_UNSPECIFIED is unsupported.

Library:

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

Description:

The navigator_invoke_select_list_item() function sends a request to the Navigator to invoke the list item selection from the list that this application belongs to.

The requesting application must be launched as an invoke list item. Success is determined by whether the request has been sent.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.