<!-- ##### 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:status-icon ##### --> <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: @attach: @Returns: <!-- ##### FUNCTION notify_notification_new_with_status_icon ##### --> <para> </para> @summary: @body: @icon: @status_icon: @Returns: <!-- ##### FUNCTION notify_notification_update ##### --> <para> </para> @notification: @summary: @body: @icon: @Returns: <!-- ##### FUNCTION notify_notification_attach_to_widget ##### --> <para> </para> @notification: @attach: <!-- ##### FUNCTION notify_notification_attach_to_status_icon ##### --> <para> </para> @notification: @status_icon: <!-- ##### FUNCTION notify_notification_set_geometry_hints ##### --> <para> </para> @notification: @screen: @x: @y: <!-- ##### 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: