New upstream version 3.24.28

This commit is contained in:
Simon McVittie
2021-04-15 09:52:10 +01:00
571 changed files with 181992 additions and 178915 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkArrow.html" title="GtkArrow">
<link rel="next" href="GtkThemingEngine.html" title="GtkThemingEngine">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -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>
@ -364,7 +364,7 @@
</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>
@ -971,7 +971,7 @@ returned pixbuf.</p>
<a name="gtk-status-icon-get-pixbuf.returns"></a><h4>Returns</h4>
<p>the displayed pixbuf,
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>
<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="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
</div>
@ -1086,7 +1086,7 @@ returned <span class="type">GIcon</span>.</p>
<div class="refsect3">
<a name="gtk-status-icon-get-gicon.returns"></a><h4>Returns</h4>
<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>
<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="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.14</p>
</div>
@ -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,8 +1201,8 @@ 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><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
<p>a <span class="type">GdkScreen</span>. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.12</p>
</div>
@ -1730,8 +1730,8 @@ to position <em class="parameter"><code>menu</code></em>
<a name="gtk-status-icon-get-geometry"></a><h3>gtk_status_icon_get_geometry ()</h3>
<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>
@ -1768,7 +1768,7 @@ is embedded in a notification area, see
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>return location for
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>
<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="The data is owned by the callee, which is responsible of freeing it."><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>
@ -1928,7 +1928,7 @@ 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>Owner: GtkStatusIcon</p>
<p>Flags: Read / Write</p>
@ -2067,7 +2067,7 @@ be used by applications and should be wrapped by language bindings.</p>
<a name="GtkStatusIcon-button-press-event"></a><h3>The <code class="literal">“button-press-event”</code> signal</h3>
<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,
<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>
@ -2089,7 +2089,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>
@ -2114,7 +2114,7 @@ for the event. <code class="literal">FALSE</code> to propagate the event further
<a name="GtkStatusIcon-button-release-event"></a><h3>The <code class="literal">“button-release-event”</code> signal</h3>
<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,
<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>
@ -2136,7 +2136,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>
@ -2301,7 +2301,7 @@ should be shown right now, <code class="literal">FALSE</code> otherwise.</p>
<a name="GtkStatusIcon-scroll-event"></a><h3>The <code class="literal">“scroll-event”</code> signal</h3>
<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,
<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
@ -2323,7 +2323,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>
@ -2390,6 +2390,6 @@ size. Otherwise, GTK+ will scale the icon as necessary.</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>