notification_alert()

Request an alert notification.

Synopsis:

#include <bps/notification.h>
 
BPS_API int notification_alert(notification_message_t *message)

Since:

BlackBerry 10.0.0

Arguments:

message

The data members of the notification.

Library:

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

Description:

The notification_alert() function requests an alert notification message.

The presence or absence of some data members controls the presentation of the notification message. All alerts generate a vibration, LED, and sound filtered by the current device and application-specific settings.

Use this function to provide dialog display options that aren't filtered by user settings. To display a dialog with feedback, supply prompt choices with the notification_message_add_prompt_choice() function.

The members required by an alert notification are:
  • item_id
The additional members that alert will consider are:
  • title
  • subtitle
  • prompt_choices
  • request_id

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus