messaging_menu_message_new ()

MessagingMenuMessage * messaging_menu_message_new       (const gchar *id,
                                                         GIcon *icon,
                                                         const gchar *title,
                                                         const gchar *subtitle,
                                                         const gchar *body,
                                                         gint64 time);

Creates a new MessagingMenuMessage.

messaging_menu_message_get_id ()

const gchar *       messaging_menu_message_get_id       (MessagingMenuMessage *msg);

messaging_menu_message_get_icon ()

GIcon *             messaging_menu_message_get_icon     (MessagingMenuMessage *msg);

messaging_menu_message_get_title ()

const gchar *       messaging_menu_message_get_title    (MessagingMenuMessage *msg);

messaging_menu_message_get_subtitle ()

const gchar *       messaging_menu_message_get_subtitle (MessagingMenuMessage *msg);

messaging_menu_message_get_body ()

const gchar *       messaging_menu_message_get_body     (MessagingMenuMessage *msg);

messaging_menu_message_get_time ()

gint64              messaging_menu_message_get_time     (MessagingMenuMessage *msg);

messaging_menu_message_get_draws_attention ()

gboolean            messaging_menu_message_get_draws_attention
                                                        (MessagingMenuMessage *msg);

messaging_menu_message_set_draws_attention ()

void                messaging_menu_message_set_draws_attention
                                                        (MessagingMenuMessage *msg,
                                                         gboolean draws_attention);

Sets whether msg is drawing attention.

messaging_menu_message_add_action ()

void                messaging_menu_message_add_action   (MessagingMenuMessage *msg,
                                                         const gchar *id,
                                                         const gchar *label,
                                                         const GVariantType *parameter_type,
                                                         GVariant *parameter_hint);

Adds an action with id and label to message. Actions are an alternative way for users to activate a message. Note that messages can still be activated without an action.

If parameter_type is non-NULL, the action is able to receive user input in addition to simply activating the action. Currently, only string parameters are supported.

A list of predefined parameters can be supplied as a GVariant array of parameter_type in parameter_hint. If parameter_hint is floating, it will be consumed.

It is recommended to add at most two actions to a message.

MessagingMenuMessage

typedef struct _MessagingMenuMessage MessagingMenuMessage;

The "body" property

  "body"                     gchar*                : Read / Write / Construct Only

First lines of the body of the message.

Default value: NULL

The "draws-attention" property

  "draws-attention"          gboolean              : Read / Write

Whether the message should draw attention.

Default value: TRUE

The "icon" property

  "icon"                     GIcon*                : Read / Write / Construct Only

Icon of the message.

The "id" property

  "id"                       gchar*                : Read / Write / Construct Only

Unique id of the message.

Default value: NULL

The "subtitle" property

  "subtitle"                 gchar*                : Read / Write / Construct Only

Subtitle of the message.

Default value: NULL

The "time" property

  "time"                     gint64                : Read / Write / Construct Only

Time the message was sent, in microseconds.

Allowed values: >= 0

Default value: 0

The "title" property

  "title"                    gchar*                : Read / Write / Construct Only

Title of the message.

Default value: NULL

The "activate" signal

void                user_function                      (MessagingMenuMessage *msg,
                                                        gchar                *action,
                                                        GVariant             *parameter,
                                                        gpointer              user_data)      : Has Details

Emitted when the user has activated the message. The message is immediately removed from the application's menu, handlers of this signal do not need to call messaging_menu_app_remove_message().