libnotify/docs/reference/tmpl/notification.sgml

<!-- ##### SECTION Title ##### -->
NotifyNotification

<!-- ##### SECTION Short_Description ##### -->
A passive pop-up notification.

<!-- ##### SECTION Long_Description ##### -->
<para>
#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.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### SECTION Image ##### -->


<!-- ##### MACRO NOTIFY_EXPIRES_DEFAULT ##### -->
<para>
The default expiration time on a notification.
</para>



<!-- ##### MACRO NOTIFY_EXPIRES_NEVER ##### -->
<para>
The notification never expires. It stays open until closed by the calling API
or the user.
</para>



<!-- ##### STRUCT NotifyNotification ##### -->
<para>
This is an opaque structure representing a notification. This should
not be used directly. Use the accessor functions below.
</para>


<!-- ##### SIGNAL NotifyNotification::closed ##### -->
<para>

</para>

@notifynotification: the object which received the signal.

<!-- ##### ARG NotifyNotification:attach-widget ##### -->
<para>

</para>

<!-- ##### ARG NotifyNotification:body ##### -->
<para>

</para>

<!-- ##### ARG NotifyNotification:closed-reason ##### -->
<para>

</para>

<!-- ##### ARG NotifyNotification:icon-name ##### -->
<para>

</para>

<!-- ##### ARG NotifyNotification:id ##### -->
<para>

</para>

<!-- ##### ARG NotifyNotification:summary ##### -->
<para>

</para>

<!-- ##### ENUM NotifyUrgency ##### -->
<para>
The urgency level of the notification.
</para>

@NOTIFY_URGENCY_LOW: 
	Low urgency. Used for unimportant notifications.
@NOTIFY_URGENCY_NORMAL: 
	Normal urgency. Used for most standard notifications.
@NOTIFY_URGENCY_CRITICAL: 
	Critical urgency. Used for very important notifications.

<!-- ##### USER_FUNCTION NotifyActionCallback ##### -->
<para>
An action callback function.
</para>

@notification: 
@action: 
@user_data: 
<!-- # Unused Parameters # -->
@Param1: The notification.
@Param2: The action ID.
@Param3: User data.


<!-- ##### MACRO NOTIFY_ACTION_CALLBACK ##### -->
<para>
A convenience macro for casting a function to a #NotifyActionCallback. This
is much like G_CALLBACK().
</para>

@func: The function to cast.


<!-- ##### FUNCTION notify_notification_new ##### -->
<para>

</para>

@summary: 
@body: 
@icon: 
@Returns: 


<!-- ##### FUNCTION notify_notification_update ##### -->
<para>

</para>

@notification: 
@summary: 
@body: 
@icon: 
@Returns: 


<!-- ##### FUNCTION notify_notification_show ##### -->
<para>

</para>

@notification: 
@error: 
@Returns: 


<!-- ##### FUNCTION notify_notification_set_timeout ##### -->
<para>

</para>

@notification: 
@timeout: 


<!-- ##### FUNCTION notify_notification_set_category ##### -->
<para>

</para>

@notification: 
@category: 


<!-- ##### FUNCTION notify_notification_set_urgency ##### -->
<para>

</para>

@notification: 
@urgency: 


<!-- ##### FUNCTION notify_notification_set_icon_from_pixbuf ##### -->
<para>

</para>

@notification: 
@icon: 


<!-- ##### FUNCTION notify_notification_set_hint_int32 ##### -->
<para>

</para>

@notification: 
@key: 
@value: 


<!-- ##### FUNCTION notify_notification_set_hint_double ##### -->
<para>

</para>

@notification: 
@key: 
@value: 


<!-- ##### FUNCTION notify_notification_set_hint_string ##### -->
<para>

</para>

@notification: 
@key: 
@value: 


<!-- ##### FUNCTION notify_notification_set_hint_byte ##### -->
<para>

</para>

@notification: 
@key: 
@value: 


<!-- ##### FUNCTION notify_notification_set_hint_byte_array ##### -->
<para>

</para>

@notification: 
@key: 
@value: 
@len: 


<!-- ##### FUNCTION notify_notification_clear_hints ##### -->
<para>

</para>

@notification: 


<!-- ##### FUNCTION notify_notification_add_action ##### -->
<para>

</para>

@notification: 
@action: 
@label: 
@callback: 
@user_data: 
@free_func: 


<!-- ##### FUNCTION notify_notification_clear_actions ##### -->
<para>

</para>

@notification: 


<!-- ##### FUNCTION notify_notification_close ##### -->
<para>

</para>

@notification: 
@error: 
@Returns: