notification_message_t

The opaque notifications argument type.

Synopsis:

#include <bps/notification.h>
 
typedef struct notification_message_t notification_message_t;

Since:

BlackBerry 10.0.0

Library:

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

Description:

This type defines the notification_message_t structure used by several functions in the notification system. Use this to create and control notification messages. The notification_message_t structure is opaque, but includes the following members:
  • Request ID (char* request_id)
  • Item ID (char* item_id)
  • Title (char* title)
  • Subtitle (char* subtitle)
  • Invocation target (char* target)
  • Invocation payload (char* payload)
  • Invocation payload URI (char* payload_uri)
  • Invocation type (char* invocation_type)
  • Invocation action (char* action)
  • Prompt Choices (dialog_prompt_t* prompt_choices)
To use this type:
  1. Instantiate a notification_message_t structure with the notification_message_create() function.
  2. Set all desired members with the notification_message_set_*() functions.
  3. Send the desired message with the notification_alert() or notification_notify() functions.
  4. Remove lingering side effects from notifications with the notification_cancel() or notification_delete() functions.
  5. Deallocate the memory reserved for the notification_message_t structure with the notification_message_destroy() function.

Last modified: 2014-09-30



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

comments powered by Disqus