Request that the list item specified by selection is invoked to replace the current list item that this application belongs to.
#include <bps/navigator_invoke.h>
BPS_API int navigator_invoke_select_list_item(navigator_invoke_list_cursor_direction_t selection)
BlackBerry 10.2.0
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.
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.
BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.