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:

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

Description:

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.

Last modified: 2014-05-14



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

comments powered by Disqus