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

@ -41,7 +41,7 @@
<tbody>
<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="gdk3-Selections.html#gdk-selection-owner-set" title="gdk_selection_owner_set ()">gdk_selection_owner_set</a> <span class="c_punctuation">()</span>
@ -49,7 +49,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="gdk3-Selections.html#gdk-selection-owner-set-for-display" title="gdk_selection_owner_set_for_display ()">gdk_selection_owner_set_for_display</a> <span class="c_punctuation">()</span>
@ -81,7 +81,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="gdk3-Selections.html#gdk-selection-property-get" title="gdk_selection_property_get ()">gdk_selection_property_get</a> <span class="c_punctuation">()</span>
@ -217,11 +217,11 @@ it will work on other GDK backends too.</p>
<a name="gdk3-Selections.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gdk-selection-owner-set"></a><h3>gdk_selection_owner_set ()</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>
gdk_selection_owner_set (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</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> send_event</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> send_event</code></em>);</pre>
<p>Sets the owner of the given selection.</p>
<div class="refsect3">
<a name="gdk-selection-owner-set.parameters"></a><h4>Parameters</h4>
@ -234,7 +234,7 @@ gdk_selection_owner_set (<em class="parameter"><code><a class="link" href="gdk3-
<tbody>
<tr>
<td class="parameter_name"><p>owner</p></td>
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <code class="literal">NULL</code> to indicate that the
the owner for the given should be unset. </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>
@ -253,7 +253,7 @@ request will be ignored.</p></td>
</tr>
<tr>
<td class="parameter_name"><p>send_event</p></td>
<td class="parameter_description"><p>if <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different
<td class="parameter_description"><p>if <code class="literal">TRUE</code>, and the new owner is different
from the current owner, the current owner
will be sent a SelectionClear event.</p></td>
<td class="parameter_annotations"> </td>
@ -263,20 +263,20 @@ will be sent a SelectionClear event.</p></td>
</div>
<div class="refsect3">
<a name="gdk-selection-owner-set.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 selection owner was successfully
<p> <code class="literal">TRUE</code> if the selection owner was successfully
changed to <em class="parameter"><code>owner</code></em>
, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
, otherwise <code class="literal">FALSE</code>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-selection-owner-set-for-display"></a><h3>gdk_selection_owner_set_for_display ()</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>
gdk_selection_owner_set_for_display (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</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> send_event</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> send_event</code></em>);</pre>
<p>Sets the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> <em class="parameter"><code>owner</code></em>
as the current owner of the selection <em class="parameter"><code>selection</code></em>
.</p>
@ -296,7 +296,7 @@ gdk_selection_owner_set_for_display (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>owner</p></td>
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the owner for
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <code class="literal">NULL</code> to indicate that the owner for
the given should be unset. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
@ -314,7 +314,7 @@ set for the given selection, the request will be ignored</p></td>
</tr>
<tr>
<td class="parameter_name"><p>send_event</p></td>
<td class="parameter_description"><p>if <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different from the current
<td class="parameter_description"><p>if <code class="literal">TRUE</code>, and the new owner is different from the current
owner, the current owner will be sent a SelectionClear event</p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -323,8 +323,8 @@ owner, the current owner will be sent a SelectionClear event</p></td>
</div>
<div class="refsect3">
<a name="gdk-selection-owner-set-for-display.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 selection owner was successfully changed to owner,
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<p> <code class="literal">TRUE</code> if the selection owner was successfully changed to owner,
otherwise <code class="literal">FALSE</code>.</p>
</div>
<p class="since">Since: 2.2</p>
</div>
@ -353,7 +353,7 @@ gdk_selection_owner_get (<em class="parameter"><code><a class="link" href="gdk3-
<a name="gdk-selection-owner-get.returns"></a><h4>Returns</h4>
<p>if there is a selection owner
for this window, and it is a window known to the current process,
the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note
the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise <code class="literal">NULL</code>. Note
that the return value may be owned by a different process if a
foreign window was previously created for that window, but a new
foreign window will never be created by this call. </p>
@ -397,7 +397,7 @@ window, but a new foreign window will never be created by this call.</p>
<p>if there is a selection owner
for this window, and it is a window known to the current
process, the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<code class="literal">NULL</code>. </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.2</p>
@ -409,7 +409,7 @@ process, the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="typ
gdk_selection_convert (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Retrieves the contents of a selection in a given
form.</p>
<div class="refsect3">
@ -452,14 +452,14 @@ the time indicated by the timestamp.</p></td>
<hr>
<div class="refsect2">
<a name="gdk-selection-property-get"></a><h3>gdk_selection_property_get ()</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>
gdk_selection_property_get (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **data</code></em>,
<em class="parameter"><code><span class="type">guchar</span> **data</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *prop_type</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> *prop_format</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *prop_format</code></em>);</pre>
<p>Retrieves selection data that was stored by the selection
data in response to a call to <a class="link" href="gdk3-Selections.html#gdk-selection-convert" title="gdk_selection_convert ()"><code class="function">gdk_selection_convert()</code></a>. This function
will not be used by applications, who should use the <a href="https://developer.gnome.org/gtk3/gtk3-Clipboards.html#GtkClipboard-struct"><span class="type">GtkClipboard</span></a>
will not be used by applications, who should use the <span class="type">GtkClipboard</span>
API instead.</p>
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
<div class="refsect3">
@ -479,8 +479,8 @@ API instead.</p>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>location to store a pointer to the retrieved data.
If the retrieval failed, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> we be stored here, otherwise, it
will be non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and the returned data should be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
If the retrieval failed, <code class="literal">NULL</code> we be stored here, otherwise, it
will be non-<code class="literal">NULL</code> and the returned data should be freed with <code class="function">g_free()</code>
when you are finished using it. The length of the
allocated memory is one more than the length
of the returned data, and the final byte will always
@ -513,7 +513,7 @@ gdk_selection_send_notify (<em class="parameter"><code><a class="link" href="gdk
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Sends a response to SelectionRequest event.</p>
<div class="refsect3">
<a name="gdk-selection-send-notify.parameters"></a><h4>Parameters</h4>
@ -564,7 +564,7 @@ gdk_selection_send_notify_for_display (<em class="parameter"><code><a class="lin
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Send a response to SelectionRequest event.</p>
<div class="refsect3">
<a name="gdk-selection-send-notify-for-display.parameters"></a><h4>Parameters</h4>