navigator_add

Create a navigator icon that, when launched, invokes the corresponding application based on the URI value.

Synopsis:

#include <bps/navigator.h>

BPS_API int navigator_add_uri(const char *icon_path,
                              const char *icon_label,
                              const char *default_category,
                              const char *url,
                              char **err)

Since:

BlackBerry 10.0.0

Arguments:

icon_path: The path to the icon image.

icon_label: The label to apply to the icon image.

default_category: The navigator tray that the icon should appear in.

url: The URI of the application to launch.

err: If this function fails, and if err is not NULL, it will be set to a short description of the error. The caller must free this buffer using bps_free().

Library:

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

Description:

The navigator_add_uri() function creates an icon in one of the navigator trays that, when launched, starts an application based on the value of url.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE upon failure with a short description of the error in err.