notification_message_add_prompt_choice()
Add a choice to a prompt notification.
Synopsis:
#include <bps/notification.h>
BPS_API int notification_message_add_prompt_choice(notification_message_t *message, const char *label, const char *context)
Since:
BlackBerry 10.0.0
Arguments:
- message
-
A pointer to the notification_message_t structure to add the prompt choice to.
- label
-
The button's label.
- context
-
The context string to return if the button is selected. This is just a convenience for the application developer and isn't required. NULL can be provided instead.
Library:
libbpsDescription:
The notification_message_add_prompt_choice() function adds a choice to a prompt notification. If the notification_message_t structure contains one or more prompt choices and is passed to the notification_alert() function, a dialog is displayed with the specified buttons. This function is used with notification_alert() only.
You can only add up to NOTIFICATION_MAX_PROMPT_CHOICES buttons to a dialog. Adding more than NOTIFICATION_MAX_PROMPT_CHOICES results in the return of BPS_FAILURE.
Returns:
BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.