| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/share/gtk-doc/html/libnotify/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>NotifyNotification</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="Libnotify Reference Manual">
<link rel="up" href="ch01.html" title="Libnotify">
<link rel="prev" href="libnotify-notify.html" title="notify">
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="Libnotify">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libnotify-notify.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Libnotify Reference Manual</th>
<td> </td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#NotifyNotification.synopsis" class="shortcut">Top</a>
|
<a href="#NotifyNotification.description" class="shortcut">Description</a>
|
<a href="#NotifyNotification.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
<a href="#NotifyNotification.properties" class="shortcut">Properties</a>
|
<a href="#NotifyNotification.signals" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="NotifyNotification"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="NotifyNotification.top_of_page"></a>NotifyNotification</span></h2>
<p>NotifyNotification — A passive pop-up notification.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="NotifyNotification.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#define <a class="link" href="NotifyNotification.html#NOTIFY-EXPIRES-DEFAULT:CAPS" title="NOTIFY_EXPIRES_DEFAULT">NOTIFY_EXPIRES_DEFAULT</a>
#define <a class="link" href="NotifyNotification.html#NOTIFY-EXPIRES-NEVER:CAPS" title="NOTIFY_EXPIRES_NEVER">NOTIFY_EXPIRES_NEVER</a>
<a class="link" href="NotifyNotification.html#NotifyNotification-struct" title="NotifyNotification">NotifyNotification</a>;
enum <a class="link" href="NotifyNotification.html#NotifyUrgency" title="enum NotifyUrgency">NotifyUrgency</a>;
void (<a class="link" href="NotifyNotification.html#NotifyActionCallback" title="NotifyActionCallback ()">*NotifyActionCallback</a>) (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *action,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
#define <a class="link" href="NotifyNotification.html#NOTIFY-ACTION-CALLBACK:CAPS" title="NOTIFY_ACTION_CALLBACK()">NOTIFY_ACTION_CALLBACK</a> (func)
<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a>* <a class="link" href="NotifyNotification.html#notify-notification-new" title="notify_notification_new ()">notify_notification_new</a> (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *attach);
<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a>* <a class="link" href="NotifyNotification.html#notify-notification-new-with-status-icon" title="notify_notification_new_with_status_icon ()">notify_notification_new_with_status_icon</a>
(const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon,
<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a> *status_icon);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="NotifyNotification.html#notify-notification-update" title="notify_notification_update ()">notify_notification_update</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon);
void <a class="link" href="NotifyNotification.html#notify-notification-attach-to-widget" title="notify_notification_attach_to_widget ()">notify_notification_attach_to_widget</a>
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *attach);
void <a class="link" href="NotifyNotification.html#notify-notification-attach-to-status-icon" title="notify_notification_attach_to_status_icon ()">notify_notification_attach_to_status_icon</a>
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a> *status_icon);
void <a class="link" href="NotifyNotification.html#notify-notification-set-geometry-hints" title="notify_notification_set_geometry_hints ()">notify_notification_set_geometry_hints</a>
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> y);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="NotifyNotification.html#notify-notification-show" title="notify_notification_show ()">notify_notification_show</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
void <a class="link" href="NotifyNotification.html#notify-notification-set-timeout" title="notify_notification_set_timeout ()">notify_notification_set_timeout</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> timeout);
void <a class="link" href="NotifyNotification.html#notify-notification-set-category" title="notify_notification_set_category ()">notify_notification_set_category</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const char *category);
void <a class="link" href="NotifyNotification.html#notify-notification-set-urgency" title="notify_notification_set_urgency ()">notify_notification_set_urgency</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a class="link" href="NotifyNotification.html#NotifyUrgency" title="enum NotifyUrgency">NotifyUrgency</a> urgency);
void <a class="link" href="NotifyNotification.html#notify-notification-set-icon-from-pixbuf" title="notify_notification_set_icon_from_pixbuf ()">notify_notification_set_icon_from_pixbuf</a>
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *icon);
void <a class="link" href="NotifyNotification.html#notify-notification-set-hint-int32" title="notify_notification_set_hint_int32 ()">notify_notification_set_hint_int32</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> value);
void <a class="link" href="NotifyNotification.html#notify-notification-set-hint-double" title="notify_notification_set_hint_double ()">notify_notification_set_hint_double</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);
void <a class="link" href="NotifyNotification.html#notify-notification-set-hint-string" title="notify_notification_set_hint_string ()">notify_notification_set_hint_string</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *value);
void <a class="link" href="NotifyNotification.html#notify-notification-set-hint-byte" title="notify_notification_set_hint_byte ()">notify_notification_set_hint_byte</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> value);
void <a class="link" href="NotifyNotification.html#notify-notification-set-hint-byte-array" title="notify_notification_set_hint_byte_array ()">notify_notification_set_hint_byte_array</a>
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *value,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
>gsize</a> len);
void <a class="link" href="NotifyNotification.html#notify-notification-clear-hints" title="notify_notification_clear_hints ()">notify_notification_clear_hints</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification);
void <a class="link" href="NotifyNotification.html#notify-notification-add-action" title="notify_notification_add_action ()">notify_notification_add_action</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const char *action,
const char *label,
<a class="link" href="NotifyNotification.html#NotifyActionCallback" title="NotifyActionCallback ()">NotifyActionCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"
>GFreeFunc</a> free_func);
void <a class="link" href="NotifyNotification.html#notify-notification-clear-actions" title="notify_notification_clear_actions ()">notify_notification_clear_actions</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="NotifyNotification.html#notify-notification-close" title="notify_notification_close ()">notify_notification_close</a> (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----NotifyNotification
</pre>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.properties"></a><h2>Properties</h2>
<pre class="synopsis">
"<a class="link" href="NotifyNotification.html#NotifyNotification--attach-widget" title='The "attach-widget" property'>attach-widget</a>" <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* : Read / Write / Construct
"<a class="link" href="NotifyNotification.html#NotifyNotification--body" title='The "body" property'>body</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct
"<a class="link" href="NotifyNotification.html#NotifyNotification--closed-reason" title='The "closed-reason" property'>closed-reason</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> : Read
"<a class="link" href="NotifyNotification.html#NotifyNotification--icon-name" title='The "icon-name" property'>icon-name</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct
"<a class="link" href="NotifyNotification.html#NotifyNotification--id" title='The "id" property'>id</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write / Construct
"<a class="link" href="NotifyNotification.html#NotifyNotification--status-icon" title='The "status-icon" property'>status-icon</a>" <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a>* : Read / Write / Construct
"<a class="link" href="NotifyNotification.html#NotifyNotification--summary" title='The "summary" property'>summary</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct
</pre>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.signals"></a><h2>Signals</h2>
<pre class="synopsis">
"<a class="link" href="NotifyNotification.html#NotifyNotification-closed" title='The "closed" signal'>closed</a>" : Run First
</pre>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.description"></a><h2>Description</h2>
<p>
<a class="link" href="NotifyNotification.html" title="NotifyNotification"><span class="type">NotifyNotification</span></a> 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.
</p>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="NOTIFY-EXPIRES-DEFAULT:CAPS"></a><h3>NOTIFY_EXPIRES_DEFAULT</h3>
<pre class="programlisting">#define NOTIFY_EXPIRES_DEFAULT -1
</pre>
<p>
The default expiration time on a notification.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NOTIFY-EXPIRES-NEVER:CAPS"></a><h3>NOTIFY_EXPIRES_NEVER</h3>
<pre class="programlisting">#define NOTIFY_EXPIRES_NEVER 0
</pre>
<p>
The notification never expires. It stays open until closed by the calling API
or the user.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification-struct"></a><h3>NotifyNotification</h3>
<pre class="programlisting">typedef struct _NotifyNotification NotifyNotification;</pre>
<p>
This is an opaque structure representing a notification. This should
not be used directly. Use the accessor functions below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyUrgency"></a><h3>enum NotifyUrgency</h3>
<pre class="programlisting">typedef enum
{
NOTIFY_URGENCY_LOW,
NOTIFY_URGENCY_NORMAL,
NOTIFY_URGENCY_CRITICAL,
} NotifyUrgency;
</pre>
<p>
The urgency level of the notification.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="NOTIFY-URGENCY-LOW:CAPS"></a><span class="term"><code class="literal">NOTIFY_URGENCY_LOW</code></span></p></td>
<td>
Low urgency. Used for unimportant notifications.
</td>
</tr>
<tr>
<td><p><a name="NOTIFY-URGENCY-NORMAL:CAPS"></a><span class="term"><code class="literal">NOTIFY_URGENCY_NORMAL</code></span></p></td>
<td>
Normal urgency. Used for most standard notifications.
</td>
</tr>
<tr>
<td><p><a name="NOTIFY-URGENCY-CRITICAL:CAPS"></a><span class="term"><code class="literal">NOTIFY_URGENCY_CRITICAL</code></span></p></td>
<td>
Critical urgency. Used for very important notifications.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyActionCallback"></a><h3>NotifyActionCallback ()</h3>
<pre class="programlisting">void (*NotifyActionCallback) (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *action,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
An action callback function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NOTIFY-ACTION-CALLBACK:CAPS"></a><h3>NOTIFY_ACTION_CALLBACK()</h3>
<pre class="programlisting">#define NOTIFY_ACTION_CALLBACK(func) ((NotifyActionCallback)(func))
</pre>
<p>
A convenience macro for casting a function to a <a class="link" href="NotifyNotification.html#NotifyActionCallback" title="NotifyActionCallback ()"><span class="type">NotifyActionCallback</span></a>. This
is much like <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS"
><code class="function">G_CALLBACK()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
<td>The function to cast.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-new"></a><h3>notify_notification_new ()</h3>
<pre class="programlisting"><a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a>* notify_notification_new (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *attach);</pre>
<p>
Creates a new <a class="link" href="NotifyNotification.html" title="NotifyNotification"><span class="type">NotifyNotification</span></a>. The summary text is required, but
all other parameters are optional.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>summary</code></em> :</span></p></td>
<td> The required summary text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>body</code></em> :</span></p></td>
<td> The optional body text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td> The optional icon theme icon name or filename.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attach</code></em> :</span></p></td>
<td> The optional widget to attach to.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The new <a class="link" href="NotifyNotification.html" title="NotifyNotification"><span class="type">NotifyNotification</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-new-with-status-icon"></a><h3>notify_notification_new_with_status_icon ()</h3>
<pre class="programlisting"><a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a>* notify_notification_new_with_status_icon
(const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon,
<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a> *status_icon);</pre>
<p>
Creates a new <a class="link" href="NotifyNotification.html" title="NotifyNotification"><span class="type">NotifyNotification</span></a> and attaches to a <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
><span class="type">GtkStatusIcon</span></a>.
The summary text and <em class="parameter"><code>status_icon</code></em> is required, but all other parameters
are optional.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>summary</code></em> :</span></p></td>
<td> The required summary text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>body</code></em> :</span></p></td>
<td> The optional body text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td> The optional icon theme icon name or filename.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>status_icon</code></em> :</span></p></td>
<td> The required <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
><span class="type">GtkStatusIcon</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The new <a class="link" href="NotifyNotification.html" title="NotifyNotification"><span class="type">NotifyNotification</span></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.4.1
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-update"></a><h3>notify_notification_update ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> notify_notification_update (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *summary,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *body,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *icon);</pre>
<p>
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
<a class="link" href="NotifyNotification.html#notify-notification-show" title="notify_notification_show ()"><code class="function">notify_notification_show()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification to update.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>summary</code></em> :</span></p></td>
<td> The new required summary text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>body</code></em> :</span></p></td>
<td> The optional body text.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td> The optional icon theme icon name or filename.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, unless an invalid parameter was passed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-attach-to-widget"></a><h3>notify_notification_attach_to_widget ()</h3>
<pre class="programlisting">void notify_notification_attach_to_widget
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *attach);</pre>
<p>
Attaches the notification to a widget. This will set hints on the
notification requesting that the notification point to the widget's
location. If <em class="parameter"><code>attach</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the widget will be unset.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>attach</code></em> :</span></p></td>
<td> The widget to attach to, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-attach-to-status-icon"></a><h3>notify_notification_attach_to_status_icon ()</h3>
<pre class="programlisting">void notify_notification_attach_to_status_icon
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a> *status_icon);</pre>
<p>
Attaches the notification to a <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
><span class="type">GtkStatusIcon</span></a>. This will set hints on the
notification requesting that the notification point to the status icon's
location. If <em class="parameter"><code>status_icon</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the status icon will be unset.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>status_icon</code></em> :</span></p></td>
<td> The <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
><span class="type">GtkStatusIcon</span></a> to attach to, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.4.1
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-geometry-hints"></a><h3>notify_notification_set_geometry_hints ()</h3>
<pre class="programlisting">void notify_notification_set_geometry_hints
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> *screen,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<p>
Sets the geometry hints on the notification. This sets the screen
the notification should appear on and the X, Y coordinates it should
point to, if the particular notification supports X, Y hints.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td> The <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
><span class="type">GdkScreen</span></a> the notification should appear on.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td> The X coordinate to point to.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td> The Y coordinate to point to.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.4.1
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-show"></a><h3>notify_notification_show ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> notify_notification_show (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Tells the notification server to display the notification on the screen.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td> The returned error information.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if successful. On error, this will return <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> and set
<em class="parameter"><code>error</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-timeout"></a><h3>notify_notification_set_timeout ()</h3>
<pre class="programlisting">void notify_notification_set_timeout (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> timeout);</pre>
<p>
Sets the timeout of the notification. To set the default time, pass
<a class="link" href="NotifyNotification.html#NOTIFY-EXPIRES-DEFAULT:CAPS" title="NOTIFY_EXPIRES_DEFAULT"><code class="literal">NOTIFY_EXPIRES_DEFAULT</code></a> as <em class="parameter"><code>timeout</code></em>. To set the notification to never
expire, pass <a class="link" href="NotifyNotification.html#NOTIFY-EXPIRES-NEVER:CAPS" title="NOTIFY_EXPIRES_NEVER"><code class="literal">NOTIFY_EXPIRES_NEVER</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
<td> The timeout in milliseconds.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-category"></a><h3>notify_notification_set_category ()</h3>
<pre class="programlisting">void notify_notification_set_category (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const char *category);</pre>
<p>
Sets the category of this notification. This can be used by the
notification server to filter or display the data in a certain way.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>category</code></em> :</span></p></td>
<td> The category.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-urgency"></a><h3>notify_notification_set_urgency ()</h3>
<pre class="programlisting">void notify_notification_set_urgency (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a class="link" href="NotifyNotification.html#NotifyUrgency" title="enum NotifyUrgency">NotifyUrgency</a> urgency);</pre>
<p>
Sets the urgency level of this notification.
</p>
<p>
See: <a class="link" href="NotifyNotification.html#NotifyUrgency" title="enum NotifyUrgency"><span class="type">NotifyUrgency</span></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>urgency</code></em> :</span></p></td>
<td> The urgency level.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-icon-from-pixbuf"></a><h3>notify_notification_set_icon_from_pixbuf ()</h3>
<pre class="programlisting">void notify_notification_set_icon_from_pixbuf
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *icon);</pre>
<p>
Sets the icon in the notification from a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>.
</p>
<p>
This will only work when libnotify is compiled against D-BUS 0.60 or
higher.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td> The icon.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-hint-int32"></a><h3>notify_notification_set_hint_int32 ()</h3>
<pre class="programlisting">void notify_notification_set_hint_int32 (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> value);</pre>
<p>
Sets a hint with a 32-bit integer value.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td> The hint.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> The hint's value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-hint-double"></a><h3>notify_notification_set_hint_double ()</h3>
<pre class="programlisting">void notify_notification_set_hint_double (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);</pre>
<p>
Sets a hint with a double value.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td> The hint.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> The hint's value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-hint-string"></a><h3>notify_notification_set_hint_string ()</h3>
<pre class="programlisting">void notify_notification_set_hint_string (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *value);</pre>
<p>
Sets a hint with a string value.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td> The hint.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> The hint's value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-hint-byte"></a><h3>notify_notification_set_hint_byte ()</h3>
<pre class="programlisting">void notify_notification_set_hint_byte (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> value);</pre>
<p>
Sets a hint with a byte value.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td> The hint.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> The hint's value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-set-hint-byte-array"></a><h3>notify_notification_set_hint_byte_array ()</h3>
<pre class="programlisting">void notify_notification_set_hint_byte_array
(<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *key,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *value,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
>gsize</a> len);</pre>
<p>
Sets a hint with a byte array value. The length of <em class="parameter"><code>value</code></em> must be passed
as <em class="parameter"><code>len</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td> The hint.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> The hint's value.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
<td> The length of the byte array.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-clear-hints"></a><h3>notify_notification_clear_hints ()</h3>
<pre class="programlisting">void notify_notification_clear_hints (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification);</pre>
<p>
Clears all hints from the notification.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-add-action"></a><h3>notify_notification_add_action ()</h3>
<pre class="programlisting">void notify_notification_add_action (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
const char *action,
const char *label,
<a class="link" href="NotifyNotification.html#NotifyActionCallback" title="NotifyActionCallback ()">NotifyActionCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"
>GFreeFunc</a> free_func);</pre>
<p>
Adds an action to a notification. When the action is invoked, the
specified callback function will be called, along with the value passed
to <em class="parameter"><code>user_data</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td> The action ID.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
<td> The human-readable action label.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td> The action's callback function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td> Optional custom data to pass to <em class="parameter"><code>callback</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>free_func</code></em> :</span></p></td>
<td> An optional function to free <em class="parameter"><code>user_data</code></em> when the notification
is destroyed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-clear-actions"></a><h3>notify_notification_clear_actions ()</h3>
<pre class="programlisting">void notify_notification_clear_actions (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification);</pre>
<p>
Clears all actions from the notification.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="notify-notification-close"></a><h3>notify_notification_close ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> notify_notification_close (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Tells the notification server to hide the notification on the screen.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The notification.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td> The returned error information.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if successful. On error, this will return <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> and set
<em class="parameter"><code>error</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="NotifyNotification--attach-widget"></a><h3>The <code class="literal">"attach-widget"</code> property</h3>
<pre class="programlisting"> "attach-widget" <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* : Read / Write / Construct</pre>
<p>The widget to attach the notification to.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--body"></a><h3>The <code class="literal">"body"</code> property</h3>
<pre class="programlisting"> "body" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct</pre>
<p>The message body text.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--closed-reason"></a><h3>The <code class="literal">"closed-reason"</code> property</h3>
<pre class="programlisting"> "closed-reason" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> : Read</pre>
<p>The reason code for why the notification was closed.</p>
<p>Allowed values: >= G_MAXULONG</p>
<p>Default value: -1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--icon-name"></a><h3>The <code class="literal">"icon-name"</code> property</h3>
<pre class="programlisting"> "icon-name" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct</pre>
<p>The icon filename or icon theme-compliant name.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--id"></a><h3>The <code class="literal">"id"</code> property</h3>
<pre class="programlisting"> "id" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write / Construct</pre>
<p>The notification ID.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--status-icon"></a><h3>The <code class="literal">"status-icon"</code> property</h3>
<pre class="programlisting"> "status-icon" <a
href="/usr/share/gtk-doc/html/gtk/GtkStatusIcon.html"
>GtkStatusIcon</a>* : Read / Write / Construct</pre>
<p>The status icon to attach the notification to.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="NotifyNotification--summary"></a><h3>The <code class="literal">"summary"</code> property</h3>
<pre class="programlisting"> "summary" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>* : Read / Write / Construct</pre>
<p>The summary text.</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="NotifyNotification.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="NotifyNotification-closed"></a><h3>The <code class="literal">"closed"</code> signal</h3>
<pre class="programlisting">void user_function (<a class="link" href="NotifyNotification.html" title="NotifyNotification">NotifyNotification</a> *notification,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run First</pre>
<p>
Emitted when the notification is closed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>notification</code></em> :</span></p></td>
<td> The object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.10</div>
</body>
</html>