New upstream version 3.24.8

This commit is contained in:
Iain Lane
2019-04-11 09:41:47 +01:00
549 changed files with 776552 additions and 386298 deletions

View File

@ -147,14 +147,14 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-stock" title="gtk_status_icon_get_stock ()">gtk_status_icon_get_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-icon-name" title="gtk_status_icon_get_icon_name ()">gtk_status_icon_get_icon_name</a> <span class="c_punctuation">()</span>
@ -170,7 +170,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-size" title="gtk_status_icon_get_size ()">gtk_status_icon_get_size</a> <span class="c_punctuation">()</span>
@ -186,7 +186,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
<span class="returnvalue">GdkScreen</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-screen" title="gtk_status_icon_get_screen ()">gtk_status_icon_get_screen</a> <span class="c_punctuation">()</span>
@ -202,7 +202,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-tooltip-text" title="gtk_status_icon_get_tooltip_text ()">gtk_status_icon_get_tooltip_text</a> <span class="c_punctuation">()</span>
@ -218,7 +218,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-tooltip-markup" title="gtk_status_icon_get_tooltip_markup ()">gtk_status_icon_get_tooltip_markup</a> <span class="c_punctuation">()</span>
@ -234,7 +234,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-has-tooltip" title="gtk_status_icon_get_has_tooltip ()">gtk_status_icon_get_has_tooltip</a> <span class="c_punctuation">()</span>
@ -249,7 +249,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-title" title="gtk_status_icon_get_title ()">gtk_status_icon_get_title</a> <span class="c_punctuation">()</span>
@ -273,7 +273,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-visible" title="gtk_status_icon_get_visible ()">gtk_status_icon_get_visible</a> <span class="c_punctuation">()</span>
@ -281,7 +281,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-is-embedded" title="gtk_status_icon_is_embedded ()">gtk_status_icon_is_embedded</a> <span class="c_punctuation">()</span>
@ -297,7 +297,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-geometry" title="gtk_status_icon_get_geometry ()">gtk_status_icon_get_geometry</a> <span class="c_punctuation">()</span>
@ -305,7 +305,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
<span class="returnvalue">guint32</span>
</td>
<td class="function_name">
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-get-x11-window-id" title="gtk_status_icon_get_x11_window_id ()">gtk_status_icon_get_x11_window_id</a> <span class="c_punctuation">()</span>
@ -324,13 +324,13 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--embedded" title="The “embedded” property">embedded</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--file" title="The “file” property">file</a></td>
<td class="property_flags">Write</td>
</tr>
@ -341,13 +341,13 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property">has-tooltip</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--icon-name" title="The “icon-name” property">icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -364,18 +364,18 @@
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td>
<span class="type">GdkScreen</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--screen" title="The “screen” property">screen</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--size" title="The “size” property">size</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--stock" title="The “stock” property">stock</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -386,24 +386,24 @@
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--title" title="The “title” property">title</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--tooltip-markup" title="The “tooltip-markup” property">tooltip-markup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--tooltip-text" title="The “tooltip-text” property">tooltip-text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon--visible" title="The “visible” property">visible</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -422,37 +422,37 @@
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-activate" title="The “activate” signal">activate</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-button-press-event" title="The “button-press-event” signal">button-press-event</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-button-release-event" title="The “button-release-event” signal">button-release-event</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-popup-menu" title="The “popup-menu” signal">popup-menu</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal">query-tooltip</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-scroll-event" title="The “scroll-event” signal">scroll-event</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkStatusIcon.html#GtkStatusIcon-size-changed" title="The “size-changed” signal">size-changed</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
@ -472,7 +472,7 @@
</div>
<div class="refsect1">
<a name="GtkStatusIcon.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GtkStatusIcon
</pre>
</div>
@ -497,12 +497,12 @@ icons as the only way to convey critical information regarding your application,
as the notification area may not exist on the user's environment, or may have
been removed. You should always check that a status icon has been embedded into
a notification area by using <a class="link" href="GtkStatusIcon.html#gtk-status-icon-is-embedded" title="gtk_status_icon_is_embedded ()"><code class="function">gtk_status_icon_is_embedded()</code></a>, and gracefully
recover if the function returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
recover if the function returns <code class="literal">FALSE</code>.</p>
<p>On X11, the implementation follows the
<a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/systemtray-spec" target="_top">FreeDesktop System Tray Specification</a>.
Implementations of the “tray” side of this specification can
be found e.g. in the GNOME 2 and KDE panel applications.</p>
<p>Note that a GtkStatusIcon is not a widget, but just a <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>. Making it a
<p>Note that a GtkStatusIcon is not a widget, but just a <span class="type">GObject</span>. Making it a
widget would be impractical, since the system tray on Windows doesnt allow
to embed arbitrary widgets.</p>
<p>GtkStatusIcon has been deprecated in 3.14. You should consider using
@ -569,7 +569,7 @@ space in the notification area, if necessary.</p>
<div class="refsect2">
<a name="gtk-status-icon-new-from-file"></a><h3>gtk_status_icon_new_from_file ()</h3>
<pre class="programlisting"><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="returnvalue">GtkStatusIcon</span></a> *
gtk_status_icon_new_from_file (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
gtk_status_icon_new_from_file (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_new_from_file</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -604,7 +604,7 @@ space in the notification area, if necessary.</p>
<div class="refsect2">
<a name="gtk-status-icon-new-from-stock"></a><h3>gtk_status_icon_new_from_stock ()</h3>
<pre class="programlisting"><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="returnvalue">GtkStatusIcon</span></a> *
gtk_status_icon_new_from_stock (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
gtk_status_icon_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_new_from_stock</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -639,7 +639,7 @@ own stock icon names, see <a class="link" href="gtk3-Themeable-Stock-Images.html
<div class="refsect2">
<a name="gtk-status-icon-new-from-icon-name"></a><h3>gtk_status_icon_new_from_icon_name ()</h3>
<pre class="programlisting"><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="returnvalue">GtkStatusIcon</span></a> *
gtk_status_icon_new_from_icon_name (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
gtk_status_icon_new_from_icon_name (<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_new_from_icon_name</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -734,7 +734,7 @@ See <a class="link" href="GtkStatusIcon.html#gtk-status-icon-new-from-pixbuf" ti
</tr>
<tr>
<td class="parameter_name"><p>pixbuf</p></td>
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -747,7 +747,7 @@ See <a class="link" href="GtkStatusIcon.html#gtk-status-icon-new-from-pixbuf" ti
<a name="gtk-status-icon-set-from-file"></a><h3>gtk_status_icon_set_from_file ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_from_file (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_from_file</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -787,7 +787,7 @@ See <a class="link" href="GtkStatusIcon.html#gtk-status-icon-new-from-file" titl
<a name="gtk-status-icon-set-from-stock"></a><h3>gtk_status_icon_set_from_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_from_stock (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkStatusIcon.html#gtk-status-icon-set-from-icon-name" title="gtk_status_icon_set_from_icon_name ()"><code class="function">gtk_status_icon_set_from_icon_name()</code></a> instead.</p>
@ -825,7 +825,7 @@ See <a class="link" href="GtkStatusIcon.html#gtk-status-icon-new-from-stock" tit
<a name="gtk-status-icon-set-from-icon-name"></a><h3>gtk_status_icon_set_from_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_from_icon_name (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_from_icon_name</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -970,7 +970,7 @@ returned pixbuf.</p>
<div class="refsect3">
<a name="gtk-status-icon-get-pixbuf.returns"></a><h4>Returns</h4>
<p>the displayed pixbuf,
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image is empty. </p>
or <code class="literal">NULL</code> if the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -978,7 +978,7 @@ or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-stock"></a><h3>gtk_status_icon_get_stock ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_status_icon_get_stock (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -1007,7 +1007,7 @@ be freed or modified.</p>
<div class="refsect3">
<a name="gtk-status-icon-get-stock.returns"></a><h4>Returns</h4>
<p>stock id of the displayed stock icon,
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image is empty. </p>
or <code class="literal">NULL</code> if the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -1015,7 +1015,7 @@ or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-icon-name"></a><h3>gtk_status_icon_get_icon_name ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_status_icon_get_icon_name (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_icon_name</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1045,7 +1045,7 @@ be freed or modified.</p>
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-icon-name.returns"></a><h4>Returns</h4>
<p>name of the displayed icon, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image is empty. </p>
<p>name of the displayed icon, or <code class="literal">NULL</code> if the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -1085,7 +1085,7 @@ returned <span class="type">GIcon</span>.</p>
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-gicon.returns"></a><h4>Returns</h4>
<p>the displayed icon, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image is empty. </p>
<p>the displayed icon, or <code class="literal">NULL</code> if the image is empty. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.14</p>
@ -1093,7 +1093,7 @@ returned <span class="type">GIcon</span>.</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-size"></a><h3>gtk_status_icon_get_size ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_status_icon_get_size (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_size</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1135,15 +1135,15 @@ status icon is embedded (see <a class="link" href="GtkStatusIcon.html#gtk-status
<a name="gtk-status-icon-set-screen"></a><h3>gtk_status_icon_set_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_screen (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_screen</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
provide status notifications; there is no direct replacement
for this function, as GTK typically only has one <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>
for this function, as GTK typically only has one <span class="type">GdkScreen</span>
and notifications are managed by the platform</p>
</div>
<p>Sets the <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> where <em class="parameter"><code>status_icon</code></em>
<p>Sets the <span class="type">GdkScreen</span> where <em class="parameter"><code>status_icon</code></em>
is displayed; if
the icon is already mapped, it will be unmapped, and
then remapped on the new screen.</p>
@ -1163,7 +1163,7 @@ then remapped on the new screen.</p>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td>
<td class="parameter_description"><p>a <span class="type">GdkScreen</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1174,7 +1174,7 @@ then remapped on the new screen.</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-screen"></a><h3>gtk_status_icon_get_screen ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> *
<pre class="programlisting"><span class="returnvalue">GdkScreen</span> *
gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_screen</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1182,7 +1182,7 @@ gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="Gt
provide status notifications; there is no direct replacement
for this function, as notifications are managed by the platform</p>
</div>
<p>Returns the <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> associated with <em class="parameter"><code>status_icon</code></em>
<p>Returns the <span class="type">GdkScreen</span> associated with <em class="parameter"><code>status_icon</code></em>
.</p>
<div class="refsect3">
<a name="gtk-status-icon-get-screen.parameters"></a><h4>Parameters</h4>
@ -1201,7 +1201,7 @@ gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="Gt
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-screen.returns"></a><h4>Returns</h4>
<p>a <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a>. </p>
<p>a <span class="type">GdkScreen</span>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.12</p>
@ -1211,7 +1211,7 @@ gtk_status_icon_get_screen (<em class="parameter"><code><a class="link" href="Gt
<a name="gtk-status-icon-set-tooltip-text"></a><h3>gtk_status_icon_set_tooltip_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_tooltip_text (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_tooltip_text</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1221,7 +1221,7 @@ gtk_status_icon_set_tooltip_text (<em class="parameter"><code><a class="link" hr
<p>Sets <em class="parameter"><code>text</code></em>
as the contents of the tooltip.</p>
<p>This function will take care of setting <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> to
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and of the default handler for the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a>
<code class="literal">TRUE</code> and of the default handler for the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a>
signal.</p>
<p>See also the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--tooltip-text" title="The “tooltip-text” property"><span class="type">“tooltip-text”</span></a> property and
<a class="link" href="GtkTooltip.html#gtk-tooltip-set-text" title="gtk_tooltip_set_text ()"><code class="function">gtk_tooltip_set_text()</code></a>.</p>
@ -1253,7 +1253,7 @@ signal.</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-tooltip-text"></a><h3>gtk_status_icon_get_tooltip_text ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_status_icon_get_tooltip_text (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_tooltip_text</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1280,8 +1280,8 @@ gtk_status_icon_get_tooltip_text (<em class="parameter"><code><a class="link" hr
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-tooltip-text.returns"></a><h4>Returns</h4>
<p>the tooltip text, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free the
returned string with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done. </p>
<p>the tooltip text, or <code class="literal">NULL</code>. You should free the
returned string with <code class="function">g_free()</code> when done. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
@ -1291,7 +1291,7 @@ returned string with <a href="https://developer.gnome.org/glib/unstable/glib-Mem
<a name="gtk-status-icon-set-tooltip-markup"></a><h3>gtk_status_icon_set_tooltip_markup ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_tooltip_markup</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1301,7 +1301,7 @@ gtk_status_icon_set_tooltip_markup (<em class="parameter"><code><a class="link"
<p>Sets <em class="parameter"><code>markup</code></em>
as the contents of the tooltip, which is marked up with
the Pango text markup language.</p>
<p>This function will take care of setting <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
<p>This function will take care of setting <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> to <code class="literal">TRUE</code>
and of the default handler for the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> signal.</p>
<p>See also the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--tooltip-markup" title="The “tooltip-markup” property"><span class="type">“tooltip-markup”</span></a> property and
<a class="link" href="GtkTooltip.html#gtk-tooltip-set-markup" title="gtk_tooltip_set_markup ()"><code class="function">gtk_tooltip_set_markup()</code></a>.</p>
@ -1322,7 +1322,7 @@ and of the default handler for the <a class="link" href="GtkStatusIcon.html#GtkS
<tr>
<td class="parameter_name"><p>markup</p></td>
<td class="parameter_description"><p>the contents of the tooltip for <em class="parameter"><code>status_icon</code></em>
, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1333,7 +1333,7 @@ and of the default handler for the <a class="link" href="GtkStatusIcon.html#GtkS
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-tooltip-markup"></a><h3>gtk_status_icon_get_tooltip_markup ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_status_icon_get_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_tooltip_markup</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1360,8 +1360,8 @@ gtk_status_icon_get_tooltip_markup (<em class="parameter"><code><a class="link"
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-tooltip-markup.returns"></a><h4>Returns</h4>
<p>the tooltip text, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free the
returned string with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done. </p>
<p>the tooltip text, or <code class="literal">NULL</code>. You should free the
returned string with <code class="function">g_free()</code> when done. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
@ -1371,7 +1371,7 @@ returned string with <a href="https://developer.gnome.org/glib/unstable/glib-Mem
<a name="gtk-status-icon-set-has-tooltip"></a><h3>gtk_status_icon_set_has_tooltip ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_has_tooltip (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_tooltip</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> has_tooltip</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_has_tooltip</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1411,7 +1411,7 @@ has a tooltip</p></td>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-has-tooltip"></a><h3>gtk_status_icon_get_has_tooltip ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_status_icon_get_has_tooltip (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_has_tooltip</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1448,7 +1448,7 @@ See <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="
<a name="gtk-status-icon-set-title"></a><h3>gtk_status_icon_set_title ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_title (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_title</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1486,7 +1486,7 @@ readers to render the tray icon.</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-title"></a><h3>gtk_status_icon_get_title ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_status_icon_get_title (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_title</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1521,7 +1521,7 @@ gtk_status_icon_get_title (<em class="parameter"><code><a class="link" href="Gtk
<a name="gtk-status-icon-set-name"></a><h3>gtk_status_icon_set_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_name (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_name</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1562,7 +1562,7 @@ the user.</p>
<a name="gtk-status-icon-set-visible"></a><h3>gtk_status_icon_set_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_set_visible (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> visible</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> visible</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_set_visible</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1586,7 +1586,7 @@ gtk_status_icon_set_visible (<em class="parameter"><code><a class="link" href="G
</tr>
<tr>
<td class="parameter_name"><p>visible</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show the status icon, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to hide it</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to show the status icon, <code class="literal">FALSE</code> to hide it</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1597,7 +1597,7 @@ gtk_status_icon_set_visible (<em class="parameter"><code><a class="link" href="G
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-visible"></a><h3>gtk_status_icon_get_visible ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_status_icon_get_visible (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_visible</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1626,14 +1626,14 @@ the user can actually see the icon, see also
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-visible.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the status icon is visible</p>
<p> <code class="literal">TRUE</code> if the status icon is visible</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-is-embedded"></a><h3>gtk_status_icon_is_embedded ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_status_icon_is_embedded (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_is_embedded</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1660,7 +1660,7 @@ area.</p>
</div>
<div class="refsect3">
<a name="gtk-status-icon-is-embedded.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the status icon is embedded in
<p> <code class="literal">TRUE</code> if the status icon is embedded in
a notification area.</p>
</div>
<p class="since">Since: 2.10</p>
@ -1670,10 +1670,10 @@ a notification area.</p>
<a name="gtk-status-icon-position-menu"></a><h3>gtk_status_icon_position_menu ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_status_icon_position_menu (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *push_in</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> *push_in</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_position_menu</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
<p>Use <span class="type">GNotification</span> and <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a> to
@ -1728,10 +1728,10 @@ to position <em class="parameter"><code>menu</code></em>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-geometry"></a><h3>gtk_status_icon_get_geometry ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_status_icon_get_geometry (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> **screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *area</code></em>,
<em class="parameter"><code><span class="type">GdkScreen</span> **screen</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *area</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> *orientation</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_geometry</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1767,20 +1767,20 @@ is embedded in a notification area, see
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>return location for
the screen, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the information is not needed. </p></td>
the screen, or <code class="literal">NULL</code> if the information is not needed. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>area</p></td>
<td class="parameter_description"><p>return location for the area occupied by
the status icon, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
the status icon, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>orientation</p></td>
<td class="parameter_description"><p>return location for the
orientation of the panel in which the status icon is embedded,
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. A panel at the top or bottom of the screen is
or <code class="literal">NULL</code>. A panel at the top or bottom of the screen is
horizontal, a panel at the left or right is vertical. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -1789,7 +1789,7 @@ horizontal, a panel at the left or right is vertical. </p></td>
</div>
<div class="refsect3">
<a name="gtk-status-icon-get-geometry.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the location information has
<p> <code class="literal">TRUE</code> if the location information has
been filled in</p>
</div>
<p class="since">Since: 2.10</p>
@ -1797,7 +1797,7 @@ been filled in</p>
<hr>
<div class="refsect2">
<a name="gtk-status-icon-get-x11-window-id"></a><h3>gtk_status_icon_get_x11_window_id ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>
<pre class="programlisting"><span class="returnvalue">guint32</span>
gtk_status_icon_get_x11_window_id (<em class="parameter"><code><a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_status_icon_get_x11_window_id</code> has been deprecated since version 3.14 and should not be used in newly-written code.</p>
@ -1848,8 +1848,8 @@ underlying X11 Window</p>
<a name="GtkStatusIcon.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkStatusIcon--embedded"></a><h3>The <code class="literal">“embedded”</code> property</h3>
<pre class="programlisting"> “embedded” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the statusicon is embedded in a notification area.</p>
<pre class="programlisting"> “embedded” <span class="type">gboolean</span></pre>
<p><code class="literal">TRUE</code> if the statusicon is embedded in a notification area.</p>
<p>Flags: Read</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.12</p>
@ -1857,7 +1857,7 @@ underlying X11 Window</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--file"></a><h3>The <code class="literal">“file”</code> property</h3>
<pre class="programlisting"> “file” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “file” <span class="type">gchar</span> *</pre>
<p>Filename to load and display.</p>
<p>Flags: Write</p>
<p>Default value: NULL</p>
@ -1874,18 +1874,18 @@ the image will be updated automatically if the theme changes.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--has-tooltip"></a><h3>The <code class="literal">“has-tooltip”</code> property</h3>
<pre class="programlisting"> “has-tooltip” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “has-tooltip” <span class="type">gboolean</span></pre>
<p>Enables or disables the emission of <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> on
<em class="parameter"><code>status_icon</code></em>
. A value of <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> indicates that <em class="parameter"><code>status_icon</code></em>
. A value of <code class="literal">TRUE</code> indicates that <em class="parameter"><code>status_icon</code></em>
can have a
tooltip, in this case the status icon will be queried using
<a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> to determine whether it will provide a
tooltip or not.</p>
<p>Note that setting this property to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for the first time will change
<p>Note that setting this property to <code class="literal">TRUE</code> for the first time will change
the event masks of the windows of this status icon to include leave-notify
and motion-notify events. This will not be undone when the property is set
to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> again.</p>
to <code class="literal">FALSE</code> again.</p>
<p>Whether this property is respected is platform dependent.
For plain text tooltips, use <a class="link" href="GtkStatusIcon.html#GtkStatusIcon--tooltip-text" title="The “tooltip-text” property"><span class="type">“tooltip-text”</span></a> in preference.</p>
<p>Flags: Read / Write</p>
@ -1895,7 +1895,7 @@ For plain text tooltips, use <a class="link" href="GtkStatusIcon.html#GtkStatusI
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
<pre class="programlisting"> “icon-name” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “icon-name” <span class="type">gchar</span> *</pre>
<p>The name of the icon from the icon theme.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1921,14 +1921,14 @@ is embedded.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--screen"></a><h3>The <code class="literal">“screen”</code> property</h3>
<pre class="programlisting"> “screen” <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre>
<pre class="programlisting"> “screen” <span class="type">GdkScreen</span> *</pre>
<p>The screen where this status icon will be displayed.</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--size"></a><h3>The <code class="literal">“size”</code> property</h3>
<pre class="programlisting"> “size” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “size” <span class="type">gint</span></pre>
<p>The size of the icon.</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
@ -1937,7 +1937,7 @@ is embedded.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--stock"></a><h3>The <code class="literal">“stock”</code> property</h3>
<pre class="programlisting"> “stock” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “stock” <span class="type">gchar</span> *</pre>
<p>Stock ID for a stock image to display.</p>
<div class="warning">
<p><code class="literal">GtkStatusIcon:stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
@ -1957,7 +1957,7 @@ is embedded.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--title"></a><h3>The <code class="literal">“title”</code> property</h3>
<pre class="programlisting"> “title” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “title” <span class="type">gchar</span> *</pre>
<p>The title of this tray icon. This should be a short, human-readable,
localized string describing the tray icon. It may be used by tools
like screen readers to render the tray icon.</p>
@ -1968,13 +1968,13 @@ like screen readers to render the tray icon.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--tooltip-markup"></a><h3>The <code class="literal">“tooltip-markup”</code> property</h3>
<pre class="programlisting"> “tooltip-markup” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “tooltip-markup” <span class="type">gchar</span> *</pre>
<p>Sets the text of tooltip to be the given string, which is marked up
with the Pango text markup language.
Also see <a class="link" href="GtkTooltip.html#gtk-tooltip-set-markup" title="gtk_tooltip_set_markup ()"><code class="function">gtk_tooltip_set_markup()</code></a>.</p>
<p>This is a convenience property which will take care of getting the
tooltip shown if the given string is not <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
<a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> will automatically be set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and
tooltip shown if the given string is not <code class="literal">NULL</code>.
<a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> will automatically be set to <code class="literal">TRUE</code> and
the default handler for the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> signal
will take care of displaying the tooltip.</p>
<p>On some platforms, embedded markup will be ignored.</p>
@ -1985,12 +1985,12 @@ will take care of displaying the tooltip.</p>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--tooltip-text"></a><h3>The <code class="literal">“tooltip-text”</code> property</h3>
<pre class="programlisting"> “tooltip-text” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “tooltip-text” <span class="type">gchar</span> *</pre>
<p>Sets the text of tooltip to be the given string.</p>
<p>Also see <a class="link" href="GtkTooltip.html#gtk-tooltip-set-text" title="gtk_tooltip_set_text ()"><code class="function">gtk_tooltip_set_text()</code></a>.</p>
<p>This is a convenience property which will take care of getting the
tooltip shown if the given string is not <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
<a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> will automatically be set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and
tooltip shown if the given string is not <code class="literal">NULL</code>.
<a class="link" href="GtkStatusIcon.html#GtkStatusIcon--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> will automatically be set to <code class="literal">TRUE</code> and
the default handler for the <a class="link" href="GtkStatusIcon.html#GtkStatusIcon-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> signal
will take care of displaying the tooltip.</p>
<p>Note that some platforms have limitations on the length of tooltips
@ -2003,7 +2003,7 @@ that they allow on status icons, e.g. Windows only shows the first
<hr>
<div class="refsect2">
<a name="GtkStatusIcon--visible"></a><h3>The <code class="literal">“visible”</code> property</h3>
<pre class="programlisting"> “visible” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “visible” <span class="type">gboolean</span></pre>
<p>Whether the status icon is visible.</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
@ -2015,7 +2015,7 @@ that they allow on status icons, e.g. Windows only shows the first
<a name="GtkStatusIcon-activate"></a><h3>The <code class="literal">“activate”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gpointer</span> user_data)</pre>
<p>Gets emitted when the user activates the status icon.
If and how status icons can activated is platform-dependent.</p>
@ -2044,16 +2044,16 @@ be used by applications and should be wrapped by language bindings.</p>
</tbody>
</table></div>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
<p>Flags: Action</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon-button-press-event"></a><h3>The <code class="literal">“button-press-event”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">GdkEvent</span> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::button-press-event signal will be emitted when a button
(typically from a mouse) is pressed.</p>
<p>Whether this event is emitted is platform-dependent. Use the ::activate
@ -2074,7 +2074,7 @@ and ::popup-menu signals in preference.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> which triggered
<td class="parameter_description"><p>the <span class="type">GdkEventButton</span> which triggered
this signal. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span></td>
</tr>
@ -2088,19 +2088,19 @@ this signal. </p></td>
</div>
<div class="refsect3">
<a name="GtkStatusIcon-button-press-event.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked
for the event. <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p>
<p> <code class="literal">TRUE</code> to stop other handlers from being invoked
for the event. <code class="literal">FALSE</code> to propagate the event further.</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon-button-release-event"></a><h3>The <code class="literal">“button-release-event”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">GdkEvent</span> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::button-release-event signal will be emitted when a button
(typically from a mouse) is released.</p>
<p>Whether this event is emitted is platform-dependent. Use the ::activate
@ -2121,7 +2121,7 @@ and ::popup-menu signals in preference.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> which triggered
<td class="parameter_description"><p>the <span class="type">GdkEventButton</span> which triggered
this signal. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventButton]</span></td>
</tr>
@ -2135,10 +2135,10 @@ this signal. </p></td>
</div>
<div class="refsect3">
<a name="GtkStatusIcon-button-release-event.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked
for the event. <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p>
<p> <code class="literal">TRUE</code> to stop other handlers from being invoked
for the event. <code class="literal">FALSE</code> to propagate the event further.</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.14</p>
</div>
<hr>
@ -2146,9 +2146,9 @@ for the event. <a href="https://developer.gnome.org/glib/unstable/glib-Standard-
<a name="GtkStatusIcon-popup-menu"></a><h3>The <code class="literal">“popup-menu”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> activate_time,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">guint</span> button,
<span class="type">guint</span> activate_time,
<span class="type">gpointer</span> user_data)</pre>
<p>Gets emitted when the user brings up the context menu
of the status icon. Whether status icons can have context
@ -2195,19 +2195,19 @@ triggered the signal emission</p></td>
</tbody>
</table></div>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
<p>Flags: Action</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon-query-tooltip"></a><h3>The <code class="literal">“query-tooltip”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keyboard_mode,
<span class="type">gint</span> x,
<span class="type">gint</span> y,
<span class="type">gboolean</span> keyboard_mode,
<a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gpointer</span> user_data)</pre>
<p>Emitted when the hover timeout has expired with the
cursor hovering above <em class="parameter"><code>status_icon</code></em>
; or emitted when <em class="parameter"><code>status_icon</code></em>
@ -2216,9 +2216,9 @@ focus in keyboard mode.</p>
<p>Using the given coordinates, the signal handler should determine
whether a tooltip should be shown for <em class="parameter"><code>status_icon</code></em>
. If this is
the case <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> should be returned, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise. Note that if
the case <code class="literal">TRUE</code> should be returned, <code class="literal">FALSE</code> otherwise. Note that if
<em class="parameter"><code>keyboard_mode</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the values of <em class="parameter"><code>x</code></em>
is <code class="literal">TRUE</code>, the values of <em class="parameter"><code>x</code></em>
and <em class="parameter"><code>y</code></em>
are undefined and
should not be used.</p>
@ -2257,7 +2257,7 @@ emitted, relative to <em class="parameter"><code>status_icon</code></em>
</tr>
<tr>
<td class="parameter_name"><p>keyboard_mode</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the tooltip was trigged using the keyboard</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the tooltip was trigged using the keyboard</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -2275,19 +2275,19 @@ emitted, relative to <em class="parameter"><code>status_icon</code></em>
</div>
<div class="refsect3">
<a name="GtkStatusIcon-query-tooltip.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>tooltip</code></em>
should be shown right now, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>tooltip</code></em>
should be shown right now, <code class="literal">FALSE</code> otherwise.</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon-scroll-event"></a><h3>The <code class="literal">“scroll-event”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">GdkEvent</span> *event,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::scroll-event signal is emitted when a button in the 4 to 7
range is pressed. Wheel mice are usually configured to generate
button press events for buttons 4 and 5 when the wheel is turned.</p>
@ -2308,7 +2308,7 @@ button press events for buttons 4 and 5 when the wheel is turned.</p>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEventScroll"><span class="type">GdkEventScroll</span></a> which triggered
<td class="parameter_description"><p>the <span class="type">GdkEventScroll</span> which triggered
this signal. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventScroll]</span></td>
</tr>
@ -2322,19 +2322,19 @@ this signal. </p></td>
</div>
<div class="refsect3">
<a name="GtkStatusIcon-scroll-event.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the event.
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to propagate the event further.</p>
<p> <code class="literal">TRUE</code> to stop other handlers from being invoked for the event.
<code class="literal">FALSE</code> to propagate the event further.</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkStatusIcon-size-changed"></a><h3>The <code class="literal">“size-changed”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a> *status_icon,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gint</span> size,
<span class="type">gpointer</span> user_data)</pre>
<p>Gets emitted when the size available for the image
changes, e.g. because the notification area got resized.</p>
<div class="refsect3">
@ -2366,10 +2366,10 @@ changes, e.g. because the notification area got resized.</p>
</div>
<div class="refsect3">
<a name="GtkStatusIcon-size-changed.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon was updated for the new
<p> <code class="literal">TRUE</code> if the icon was updated for the new
size. Otherwise, GTK+ will scale the icon as necessary.</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.10</p>
</div>
</div>