|  |  |  | Libnotify Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
#define NOTIFY_EXPIRES_DEFAULT #define NOTIFY_EXPIRES_NEVER struct NotifyNotification; enum NotifyUrgency; void (*NotifyActionCallback) (NotifyNotification *notification,char *action,gpointer user_data); #define NOTIFY_ACTION_CALLBACK (func) NotifyNotification * notify_notification_new (const char *summary,const char *body,const char *icon); gboolean notify_notification_update (NotifyNotification *notification,const char *summary,const char *body,const char *icon); gboolean notify_notification_show (NotifyNotification *notification,GError **error); void notify_notification_set_app_name (NotifyNotification *notification,const char *app_name); void notify_notification_set_timeout (NotifyNotification *notification,gint timeout); void notify_notification_set_category (NotifyNotification *notification,const char *category); void notify_notification_set_urgency (NotifyNotification *notification,NotifyUrgency urgency); void notify_notification_set_icon_from_pixbuf (NotifyNotification *notification,GdkPixbuf *icon); void notify_notification_set_image_from_pixbuf (NotifyNotification *notification,GdkPixbuf *pixbuf); void notify_notification_set_hint (NotifyNotification *notification,const char *key,GVariant *value); void notify_notification_set_hint_int32 (NotifyNotification *notification,const char *key,gint value); void notify_notification_set_hint_uint32 (NotifyNotification *notification,const char *key,guint value); void notify_notification_set_hint_double (NotifyNotification *notification,const char *key,gdouble value); void notify_notification_set_hint_string (NotifyNotification *notification,const char *key,const char *value); void notify_notification_set_hint_byte (NotifyNotification *notification,const char *key,guchar value); void notify_notification_set_hint_byte_array (NotifyNotification *notification,const char *key,const guchar *value,gsize len); void notify_notification_clear_hints (NotifyNotification *notification); void notify_notification_add_action (NotifyNotification *notification,const char *action,const char *label,NotifyActionCallback callback,gpointer user_data,GFreeFunc free_func); void notify_notification_clear_actions (NotifyNotification *notification); gboolean notify_notification_close (NotifyNotification *notification,GError **error); gint notify_notification_get_closed_reason (const NotifyNotification *notification);
"app-name" gchar* : Read / Write "body" gchar* : Read / Write / Construct "closed-reason" gint : Read "icon-name" gchar* : Read / Write / Construct "id" gint : Read / Write / Construct "summary" gchar* : Read / Write / Construct
NotifyNotification represents a passive pop-up notification. It can contain summary text, body text, and an icon, as well as hints specifying how the notification should be presented. The notification is rendered by a notification daemon, and may present the notification in any number of ways. As such, there is a clear separation of content and presentation, and this API enforces that.
#define NOTIFY_EXPIRES_DEFAULT -1
The default expiration time on a notification.
#define NOTIFY_EXPIRES_NEVER 0
The notification never expires. It stays open until closed by the calling API or the user.
typedef enum {
        NOTIFY_URGENCY_LOW,
        NOTIFY_URGENCY_NORMAL,
        NOTIFY_URGENCY_CRITICAL,
} NotifyUrgency;
The urgency level of the notification.
void (*NotifyActionCallback) (NotifyNotification *notification,char *action,gpointer user_data);
An action callback function.
#define NOTIFY_ACTION_CALLBACK(func) ((NotifyActionCallback)(func))
A convenience macro for casting a function to a NotifyActionCallback. This
is much like G_CALLBACK().
| 
 | The function to cast. | 
NotifyNotification * notify_notification_new (const char *summary,const char *body,const char *icon);
Creates a new NotifyNotification. The summary text is required, but all other parameters are optional.
| 
 | The required summary text. | 
| 
 | The optional body text. [allow-none] | 
| 
 | The optional icon theme icon name or filename. [allow-none] | 
| Returns : | The new NotifyNotification. | 
gboolean notify_notification_update (NotifyNotification *notification,const char *summary,const char *body,const char *icon);
Updates the notification text and icon. This won't send the update out
and display it on the screen. For that, you will need to call
notify_notification_show().
| 
 | The notification to update. | 
| 
 | The new required summary text. | 
| 
 | The optional body text. [allow-none] | 
| 
 | The optional icon theme icon name or filename. [allow-none] | 
| Returns : | TRUE, unless an invalid parameter was passed. | 
gboolean notify_notification_show (NotifyNotification *notification,GError **error);
Tells the notification server to display the notification on the screen.
void notify_notification_set_app_name (NotifyNotification *notification,const char *app_name);
Sets the application name for the notification. If this function is
not called or if app_name is NULL, the application name will be
set from the value used in notify_init() or overridden with
notify_set_app_name().
| 
 | a NotifyNotification | 
| 
 | the localised application name | 
Since 0.7.3
void notify_notification_set_timeout (NotifyNotification *notification,gint timeout);
Sets the timeout of the notification. To set the default time, pass
NOTIFY_EXPIRES_DEFAULT as timeout. To set the notification to never
expire, pass NOTIFY_EXPIRES_NEVER.
| 
 | The notification. | 
| 
 | The timeout in milliseconds. | 
void notify_notification_set_category (NotifyNotification *notification,const char *category);
Sets the category of this notification. This can be used by the notification server to filter or display the data in a certain way.
| 
 | The notification. | 
| 
 | The category. | 
void notify_notification_set_urgency (NotifyNotification *notification,NotifyUrgency urgency);
Sets the urgency level of this notification.
See: NotifyUrgency
| 
 | The notification. | 
| 
 | The urgency level. | 
void notify_notification_set_icon_from_pixbuf (NotifyNotification *notification,GdkPixbuf *icon);
notify_notification_set_icon_from_pixbuf is deprecated and should not be used in newly-written code. use notify_notification_set_image_from_pixbuf() instead.
Sets the icon in the notification from a GdkPixbuf.
| 
 | The notification. | 
| 
 | The icon. | 
void notify_notification_set_image_from_pixbuf (NotifyNotification *notification,GdkPixbuf *pixbuf);
Sets the image in the notification from a GdkPixbuf.
| 
 | The notification. | 
| 
 | The image. | 
void notify_notification_set_hint (NotifyNotification *notification,const char *key,GVariant *value);
Sets a hint for key with value value. If value is NULL,
a previously set hint for key is unset.
If value is floating, it is consumed.
| 
 | a NotifyNotification | 
| 
 | the hint key | 
| 
 | the hint value, or NULLto unset the hint. [allow-none] | 
Since 0.6
void notify_notification_set_hint_int32 (NotifyNotification *notification,const char *key,gint value);
notify_notification_set_hint_int32 is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with a 32-bit integer value.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
void notify_notification_set_hint_uint32 (NotifyNotification *notification,const char *key,guint value);
notify_notification_set_hint_uint32 is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with an unsigned 32-bit integer value.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
void notify_notification_set_hint_double (NotifyNotification *notification,const char *key,gdouble value);
notify_notification_set_hint_double is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with a double value.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
void notify_notification_set_hint_string (NotifyNotification *notification,const char *key,const char *value);
notify_notification_set_hint_string is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with a string value.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
void notify_notification_set_hint_byte (NotifyNotification *notification,const char *key,guchar value);
notify_notification_set_hint_byte is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with a byte value.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
void notify_notification_set_hint_byte_array (NotifyNotification *notification,const char *key,const guchar *value,gsize len);
notify_notification_set_hint_byte_array is deprecated and should not be used in newly-written code. 0.6. Use notify_notification_set_hint() instead
Sets a hint with a byte array value. The length of value must be passed
as len.
| 
 | The notification. | 
| 
 | The hint. | 
| 
 | The hint's value. | 
| 
 | The length of the byte array. | 
void                notify_notification_clear_hints     (NotifyNotification *notification);
Clears all hints from the notification.
| 
 | The notification. | 
void notify_notification_add_action (NotifyNotification *notification,const char *action,const char *label,NotifyActionCallback callback,gpointer user_data,GFreeFunc free_func);
Adds an action to a notification. When the action is invoked, the
specified callback function will be called, along with the value passed
to user_data.
| 
 | The notification. | 
| 
 | The action ID. | 
| 
 | The human-readable action label. | 
| 
 | The action's callback function. [scope async] | 
| 
 | Optional custom data to pass to callback. [allow-none] | 
| 
 | An optional function to free user_datawhen the notification
is destroyed. [scope async][allow-none] | 
void                notify_notification_clear_actions   (NotifyNotification *notification);
Clears all actions from the notification.
| 
 | The notification. | 
gboolean notify_notification_close (NotifyNotification *notification,GError **error);
Synchronously tells the notification server to hide the notification on the screen.
gint                notify_notification_get_closed_reason
                                                        (const NotifyNotification *notification);
Returns the closed reason code for the notification. This is valid only after the "closed" signal is emitted.
| 
 | The notification. | 
| Returns : | The closed reason code. | 
"app-name" property"app-name" gchar* : Read / Write
The application name to use for this notification.
Default value: NULL
"body" property"body" gchar* : Read / Write / Construct
The message body text.
Default value: NULL
"closed-reason" property"closed-reason" gint : Read
The reason code for why the notification was closed.
Allowed values: >= G_MAXULONG
Default value: -1
"icon-name" property"icon-name" gchar* : Read / Write / Construct
The icon filename or icon theme-compliant name.
Default value: NULL
"id" property"id" gint : Read / Write / Construct
The notification ID.
Allowed values: >= 0
Default value: 0
"summary" property"summary" gchar* : Read / Write / Construct
The summary text.
Default value: NULL
"closed" signalvoid                user_function                      (NotifyNotification *notification,
                                                        gpointer            user_data)         : Run First
Emitted when the notification is closed.
| 
 | The object which received the signal. | 
| 
 | user data set when the signal handler was connected. |