notification_message_set

Set the badge member of message.

Synopsis:

#include <bps/notification.h>

BPS_API int notification_message_set_badge(notification_message_t *message) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

message: A pointer to the notification_message_t structure whose badge you want to set.

Library:

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

Description:

Deprecated:

This function is deprecated. By default, we will put up badge if applicable.

The notification_message_set_badge() function causes a splat to appear on the application specified by the app_id (see image below for an example of a splat applied to the "Messages" application icon). Use the notification_cancel() function with the corresponding app_id to remove the splat. The badge member is valid only for the notification_notify() function.

If you don't call this function, settings will control whether or not a badge is added.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.