New upstream version 3.24.5

This commit is contained in:
Jeremy Bicha
2019-02-04 16:36:47 -05:00
512 changed files with 389739 additions and 466248 deletions

View File

@ -147,7 +147,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-target-list-find" title="gtk_target_list_find ()">gtk_target_list_find</a> <span class="c_punctuation">()</span>
@ -171,7 +171,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-owner-set" title="gtk_selection_owner_set ()">gtk_selection_owner_set</a> <span class="c_punctuation">()</span>
@ -179,7 +179,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-owner-set-for-display" title="gtk_selection_owner_set_for_display ()">gtk_selection_owner_set_for_display</a> <span class="c_punctuation">()</span>
@ -211,7 +211,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-convert" title="gtk_selection_convert ()">gtk_selection_convert</a> <span class="c_punctuation">()</span>
@ -227,7 +227,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-set-text" title="gtk_selection_data_set_text ()">gtk_selection_data_set_text</a> <span class="c_punctuation">()</span>
@ -235,7 +235,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-text" title="gtk_selection_data_get_text ()">gtk_selection_data_get_text</a> <span class="c_punctuation">()</span>
@ -243,7 +243,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-set-pixbuf" title="gtk_selection_data_set_pixbuf ()">gtk_selection_data_set_pixbuf</a> <span class="c_punctuation">()</span>
@ -259,7 +259,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-set-uris" title="gtk_selection_data_set_uris ()">gtk_selection_data_set_uris</a> <span class="c_punctuation">()</span>
@ -267,7 +267,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> **
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-uris" title="gtk_selection_data_get_uris ()">gtk_selection_data_get_uris</a> <span class="c_punctuation">()</span>
@ -275,7 +275,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-targets" title="gtk_selection_data_get_targets ()">gtk_selection_data_get_targets</a> <span class="c_punctuation">()</span>
@ -283,7 +283,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-targets-include-image" title="gtk_selection_data_targets_include_image ()">gtk_selection_data_targets_include_image</a> <span class="c_punctuation">()</span>
@ -291,7 +291,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-targets-include-text" title="gtk_selection_data_targets_include_text ()">gtk_selection_data_targets_include_text</a> <span class="c_punctuation">()</span>
@ -299,7 +299,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-targets-include-uri" title="gtk_selection_data_targets_include_uri ()">gtk_selection_data_targets_include_uri</a> <span class="c_punctuation">()</span>
@ -307,7 +307,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-targets-include-rich-text" title="gtk_selection_data_targets_include_rich_text ()">gtk_selection_data_targets_include_rich_text</a> <span class="c_punctuation">()</span>
@ -322,7 +322,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">guchar</span> *
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-data" title="gtk_selection_data_get_data ()">gtk_selection_data_get_data</a> <span class="c_punctuation">()</span>
@ -330,14 +330,14 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-length" title="gtk_selection_data_get_length ()">gtk_selection_data_get_length</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">guchar</span> *
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-data-with-length" title="gtk_selection_data_get_data_with_length ()">gtk_selection_data_get_data_with_length</a> <span class="c_punctuation">()</span>
@ -361,7 +361,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-selection-data-get-format" title="gtk_selection_data_get_format ()">gtk_selection_data_get_format</a> <span class="c_punctuation">()</span>
@ -377,7 +377,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-targets-include-image" title="gtk_targets_include_image ()">gtk_targets_include_image</a> <span class="c_punctuation">()</span>
@ -385,7 +385,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-targets-include-text" title="gtk_targets_include_text ()">gtk_targets_include_text</a> <span class="c_punctuation">()</span>
@ -393,7 +393,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-targets-include-uri" title="gtk_targets_include_uri ()">gtk_targets_include_uri</a> <span class="c_punctuation">()</span>
@ -401,7 +401,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-targets-include-rich-text" title="gtk_targets_include_rich_text ()">gtk_targets_include_rich_text</a> <span class="c_punctuation">()</span>
@ -499,9 +499,9 @@ associated information.</p>
<div class="refsect2">
<a name="gtk-target-entry-new"></a><h3>gtk_target_entry_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
gtk_target_entry_new (<em class="parameter"><code>const <span class="type">gchar</span> *target</code></em>,
<em class="parameter"><code><span class="type">guint</span> flags</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>);</pre>
gtk_target_entry_new (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *target</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>);</pre>
<p>Makes a new <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>.</p>
<div class="refsect3">
<a name="gtk-target-entry-new.parameters"></a><h4>Parameters</h4>
@ -592,7 +592,7 @@ gtk_target_entry_free (<em class="parameter"><code><a class="link" href="gtk3-Se
<a name="gtk-target-list-new"></a><h3>gtk_target_list_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="returnvalue">GtkTargetList</span></a> *
gtk_target_list_new (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">guint</span> ntargets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> ntargets</code></em>);</pre>
<p>Creates a new <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> from an array of <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>.</p>
<div class="refsect3">
<a name="gtk-target-list-new.parameters"></a><h4>Parameters</h4>
@ -679,8 +679,8 @@ If the resulting reference count is zero, frees the list.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><span class="type">guint</span> flags</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> flags</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>);</pre>
<p>Appends another target to a <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>.</p>
<div class="refsect3">
<a name="gtk-target-list-add.parameters"></a><h4>Parameters</h4>
@ -721,7 +721,7 @@ gtk_target_list_add (<em class="parameter"><code><a class="link" href="gtk3-Sele
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add_table (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">guint</span> ntargets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> ntargets</code></em>);</pre>
<p>Prepends a table of <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> to a target list.</p>
<div class="refsect3">
<a name="gtk-target-list-add-table.parameters"></a><h4>Parameters</h4>
@ -756,7 +756,7 @@ gtk_target_list_add_table (<em class="parameter"><code><a class="link" href="gtk
<a name="gtk-target-list-add-text-targets"></a><h3>gtk_target_list_add_text_targets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add_text_targets (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>);</pre>
<p>Appends the text targets supported by <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>
.</p>
@ -789,8 +789,8 @@ the target list. All targets are added with the same <em class="parameter"><code
<a name="gtk-target-list-add-image-targets"></a><h3>gtk_target_list_add_image_targets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add_image_targets (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> writable</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</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> writable</code></em>);</pre>
<p>Appends the image targets supported by <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>
.</p>
@ -829,7 +829,7 @@ how to convert a pixbuf into the format</p></td>
<a name="gtk-target-list-add-uri-targets"></a><h3>gtk_target_list_add_uri_targets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add_uri_targets (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>);</pre>
<p>Appends the URI targets supported by <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>
.</p>
@ -862,8 +862,8 @@ the target list. All targets are added with the same <em class="parameter"><code
<a name="gtk-target-list-add-rich-text-targets"></a><h3>gtk_target_list_add_rich_text_targets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_list_add_rich_text_targets (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> deserializable</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</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> deserializable</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
<p>Appends the rich text targets registered with
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
@ -891,7 +891,7 @@ targets are added with the same <em class="parameter"><code>info</code></em>
</tr>
<tr>
<td class="parameter_name"><p>deserializable</p></td>
<td class="parameter_description"><p>if <code class="literal">TRUE</code>, then deserializable rich text formats
<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>, then deserializable rich text formats
will be added, serializable formats otherwise.</p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -938,10 +938,10 @@ gtk_target_list_remove (<em class="parameter"><code><a class="link" href="gtk3-S
<hr>
<div class="refsect2">
<a name="gtk-target-list-find"></a><h3>gtk_target_list_find ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_target_list_find (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><span class="type">guint</span> *info</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *info</code></em>);</pre>
<p>Looks up a given target in a <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>.</p>
<div class="refsect3">
<a name="gtk-target-list-find.parameters"></a><h4>Parameters</h4>
@ -965,7 +965,7 @@ gtk_target_list_find (<em class="parameter"><code><a class="link" href="gtk3-Sel
<tr>
<td class="parameter_name"><p>info</p></td>
<td class="parameter_description"><p>a pointer to the location to store
application info for target, or <code class="literal">NULL</code>. </p></td>
application info for target, 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_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>
</tbody>
@ -973,7 +973,7 @@ application info for target, or <code class="literal">NULL</code>. </p></td>
</div>
<div class="refsect3">
<a name="gtk-target-list-find.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the target was found, otherwise <code class="literal">FALSE</code></p>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target was found, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
</div>
</div>
<hr>
@ -981,7 +981,7 @@ application info for target, or <code class="literal">NULL</code>. </p></td>
<a name="gtk-target-table-free"></a><h3>gtk_target_table_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_table_free (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);</pre>
<p>This function frees a target table as returned by
<a class="link" href="gtk3-Selections.html#gtk-target-table-new-from-list" title="gtk_target_table_new_from_list ()"><code class="function">gtk_target_table_new_from_list()</code></a></p>
<div class="refsect3">
@ -1013,7 +1013,7 @@ gtk_target_table_free (<em class="parameter"><code><a class="link" href="gtk3-Se
<a name="gtk-target-table-new-from-list"></a><h3>gtk_target_table_new_from_list ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
gtk_target_table_new_from_list (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *list</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_targets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_targets</code></em>);</pre>
<p>This function creates an <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> array that contains the
same targets as the passed <code class="literal">list</code>. The returned table is newly
allocated and should be freed using <a class="link" href="gtk3-Selections.html#gtk-target-table-free" title="gtk_target_table_free ()"><code class="function">gtk_target_table_free()</code></a> when no
@ -1050,13 +1050,13 @@ longer needed.</p>
<hr>
<div class="refsect2">
<a name="gtk-selection-owner-set"></a><h3>gtk_selection_owner_set ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_owner_set (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<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>
<p>Claims ownership of a given selection for a particular widget,
or, if <em class="parameter"><code>widget</code></em>
is <code class="literal">NULL</code>, release ownership of the selection.</p>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, release ownership of the selection.</p>
<div class="refsect3">
<a name="gtk-selection-owner-set.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1068,7 +1068,7 @@ or, if <em class="parameter"><code>widget</code></em>
<tbody>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</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_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>
<tr>
@ -1086,20 +1086,20 @@ or, if <em class="parameter"><code>widget</code></em>
</div>
<div class="refsect3">
<a name="gtk-selection-owner-set.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the operation succeeded</p>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeded</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-owner-set-for-display"></a><h3>gtk_selection_owner_set_for_display ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_owner_set_for_display (<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> *display</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<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>
<p>Claim ownership of a given selection for a particular widget, or,
if <em class="parameter"><code>widget</code></em>
is <code class="literal">NULL</code>, release ownership of the selection.</p>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, release ownership of the selection.</p>
<div class="refsect3">
<a name="gtk-selection-owner-set-for-display.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1116,7 +1116,7 @@ if <em class="parameter"><code>widget</code></em>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>new selection owner (a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>), or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>new selection owner (a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</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_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>
<tr>
@ -1145,7 +1145,7 @@ if <em class="parameter"><code>widget</code></em>
gtk_selection_add_target (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><span class="type">guint</span> info</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>);</pre>
<p>Appends a specified target to the list of supported targets for a
given widget and selection.</p>
<div class="refsect3">
@ -1188,7 +1188,7 @@ given widget and selection.</p>
gtk_selection_add_targets (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">guint</span> ntargets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> ntargets</code></em>);</pre>
<p>Prepends a table of targets to the list of supported targets
for a given widget and selection.</p>
<div class="refsect3">
@ -1259,11 +1259,11 @@ widget.</p>
<hr>
<div class="refsect2">
<a name="gtk-selection-convert"></a><h3>gtk_selection_convert ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_convert (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<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>
<p>Requests the contents of a selection. When received,
a “selection-received” signal will be generated.</p>
<div class="refsect3">
@ -1301,7 +1301,7 @@ In emergency, you could use <a href="https://developer.gnome.org/gdk3/gdk3-Event
</div>
<div class="refsect3">
<a name="gtk-selection-convert.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if requested succeeded. <code class="literal">FALSE</code> if we could not process
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if requested succeeded. <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if we could not process
request. (e.g., there was already a request in process for
this widget).</p>
</div>
@ -1312,9 +1312,9 @@ this widget).</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_selection_data_set (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> type</code></em>,
<em class="parameter"><code><span class="type">gint</span> format</code></em>,
<em class="parameter"><code>const <span class="type">guchar</span> *data</code></em>,
<em class="parameter"><code><span class="type">gint</span> length</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> format</code></em>,
<em class="parameter"><code>const <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><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>);</pre>
<p>Stores new data into a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object. Should
only be called from a selection handler callback.
Zero-terminates the stored data.</p>
@ -1359,10 +1359,10 @@ Zero-terminates the stored data.</p>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-set-text"></a><h3>gtk_selection_data_set_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_set_text (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>,
<em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</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> len</code></em>);</pre>
<p>Sets the contents of the selection from a UTF-8 encoded string.
The string is converted to the form determined by
<em class="parameter"><code>selection_data-&gt;target</code></em>
@ -1398,14 +1398,14 @@ is nul-terminated.</p></td>
</div>
<div class="refsect3">
<a name="gtk-selection-data-set-text.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the selection was successfully set,
otherwise <code class="literal">FALSE</code>.</p>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection was successfully set,
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-text"></a><h3>gtk_selection_data_get_text ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
gtk_selection_data_get_text (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Gets the contents of the selection data as a UTF-8 string.</p>
<div class="refsect3">
@ -1427,15 +1427,15 @@ gtk_selection_data_get_text (<em class="parameter"><code>const <a class="link" h
<a name="gtk-selection-data-get-text.returns"></a><h4>Returns</h4>
<p>if the selection data contained a
recognized text type and it could be converted to UTF-8, a newly
allocated string containing the converted text, otherwise <code class="literal">NULL</code>.
If the result is non-<code class="literal">NULL</code> it must be freed with <code class="function">g_free()</code>. </p>
allocated string containing the converted text, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
If the result is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it must be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> utf8][<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="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-set-pixbuf"></a><h3>gtk_selection_data_set_pixbuf ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_set_pixbuf (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
<p>Sets the contents of the selection from 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>
@ -1466,8 +1466,8 @@ The pixbuf is converted to the form determined by
</div>
<div class="refsect3">
<a name="gtk-selection-data-set-pixbuf.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the selection was successfully set,
otherwise <code class="literal">FALSE</code>.</p>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection was successfully set,
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
@ -1497,8 +1497,8 @@ gtk_selection_data_get_pixbuf (<em class="parameter"><code>const <a class="link"
<p>if the selection data
contained a recognized image type and it could be converted to 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>, a newly allocated pixbuf is returned, otherwise
<code class="literal">NULL</code>. If the result is non-<code class="literal">NULL</code> it must be freed with
<code class="function">g_object_unref()</code>. </p>
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If the result is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it must be freed with
<a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </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="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
@ -1506,9 +1506,9 @@ contained a recognized image type and it could be converted to a
<hr>
<div class="refsect2">
<a name="gtk-selection-data-set-uris"></a><h3>gtk_selection_data_set_uris ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_set_uris (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><span class="type">gchar</span> **uris</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uris</code></em>);</pre>
<p>Sets the contents of the selection from a list of URIs.
The string is converted to the form determined by
<em class="parameter"><code>selection_data-&gt;target</code></em>
@ -1529,7 +1529,7 @@ The string is converted to the form determined by
</tr>
<tr>
<td class="parameter_name"><p>uris</p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated array of
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of
strings holding URIs. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
@ -1538,15 +1538,15 @@ strings holding URIs. </p></td>
</div>
<div class="refsect3">
<a name="gtk-selection-data-set-uris.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the selection was successfully set,
otherwise <code class="literal">FALSE</code>.</p>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection was successfully set,
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-uris"></a><h3>gtk_selection_data_get_uris ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> **
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
gtk_selection_data_get_uris (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Gets the contents of the selection data as array of URIs.</p>
<div class="refsect3">
@ -1568,9 +1568,9 @@ gtk_selection_data_get_uris (<em class="parameter"><code>const <a class="link" h
<a name="gtk-selection-data-get-uris.returns"></a><h4>Returns</h4>
<p>if
the selection data contains a list of
URIs, a newly allocated <code class="literal">NULL</code>-terminated string array
containing the URIs, otherwise <code class="literal">NULL</code>. If the result is
non-<code class="literal">NULL</code> it must be freed with <code class="function">g_strfreev()</code>. </p>
URIs, a newly allocated <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array
containing the URIs, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If the result is
non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it must be freed with <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
@ -1578,10 +1578,10 @@ non-<code class="literal">NULL</code> it must be freed with <code class="functio
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-targets"></a><h3>gtk_selection_data_get_targets ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_get_targets (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> *n_atoms</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_atoms</code></em>);</pre>
<p>Gets the contents of <em class="parameter"><code>selection_data</code></em>
as an array of targets.
This can be used to interpret the results of getting
@ -1604,7 +1604,7 @@ any selection.</p>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>location to store an array of targets. The result stored
here must be freed with <code class="function">g_free()</code>. </p></td>
here must be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </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="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_atoms][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></td>
</tr>
<tr>
@ -1618,18 +1618,18 @@ here must be freed with <code class="function">g_free()</code>. </p></td>
</div>
<div class="refsect3">
<a name="gtk-selection-data-get-targets.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em>
<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>selection_data</code></em>
contains a valid
array of targets, otherwise <code class="literal">FALSE</code>.</p>
array of targets, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-targets-include-image"></a><h3>gtk_selection_data_targets_include_image ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_targets_include_image
(<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> writable</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> writable</code></em>);</pre>
<p>Given a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
determines if any of the targets in <em class="parameter"><code>targets</code></em>
can be used to
@ -1659,16 +1659,16 @@ how to convert a pixbuf into the format</p></td>
</div>
<div class="refsect3">
<a name="gtk-selection-data-targets-include-image.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em>
<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>selection_data</code></em>
holds a list of targets,
and a suitable target for images is included, otherwise <code class="literal">FALSE</code>.</p>
and a suitable target for images is included, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-targets-include-text"></a><h3>gtk_selection_data_targets_include_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_targets_include_text
(<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Given a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
@ -1692,15 +1692,15 @@ provide text.</p>
</div>
<div class="refsect3">
<a name="gtk-selection-data-targets-include-text.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em>
<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>selection_data</code></em>
holds a list of targets,
and a suitable target for text is included, otherwise <code class="literal">FALSE</code>.</p>
and a suitable target for text is included, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-targets-include-uri"></a><h3>gtk_selection_data_targets_include_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_targets_include_uri
(<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Given a <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
@ -1724,16 +1724,16 @@ provide a list or URIs.</p>
</div>
<div class="refsect3">
<a name="gtk-selection-data-targets-include-uri.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em>
<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>selection_data</code></em>
holds a list of targets,
and a suitable target for URI lists is included, otherwise <code class="literal">FALSE</code>.</p>
and a suitable target for URI lists is included, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-selection-data-targets-include-rich-text"></a><h3>gtk_selection_data_targets_include_rich_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_selection_data_targets_include_rich_text
(<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
@ -1765,10 +1765,10 @@ provide rich text.</p>
</div>
<div class="refsect3">
<a name="gtk-selection-data-targets-include-rich-text.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>selection_data</code></em>
<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>selection_data</code></em>
holds a list of targets,
and a suitable target for rich text is included,
otherwise <code class="literal">FALSE</code>.</p>
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
@ -1803,7 +1803,7 @@ gtk_selection_data_get_selection (<em class="parameter"><code>const <a class="li
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-data"></a><h3>gtk_selection_data_get_data ()</h3>
<pre class="programlisting">const <span class="returnvalue">guchar</span> *
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
gtk_selection_data_get_data (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Retrieves the raw data of the selection.</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>
@ -1833,7 +1833,7 @@ gtk_selection_data_get_data (<em class="parameter"><code>const <a class="link" h
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-length"></a><h3>gtk_selection_data_get_length ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_selection_data_get_length (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Retrieves the length of the raw data of the selection.</p>
<div class="refsect3">
@ -1860,10 +1860,10 @@ gtk_selection_data_get_length (<em class="parameter"><code>const <a class="link"
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-data-with-length"></a><h3>gtk_selection_data_get_data_with_length ()</h3>
<pre class="programlisting">const <span class="returnvalue">guchar</span> *
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> *
gtk_selection_data_get_data_with_length
(<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
<em class="parameter"><code><span class="type">gint</span> *length</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *length</code></em>);</pre>
<p>Retrieves the raw data of the selection along with its length.</p>
<p><span class="annotation">[<acronym title="Rename the original symbol's name to SYMBOL."><span class="acronym">rename-to</span></acronym> gtk_selection_data_get_data]</span></p>
<div class="refsect3">
@ -1954,7 +1954,7 @@ gtk_selection_data_get_display (<em class="parameter"><code>const <a class="link
<hr>
<div class="refsect2">
<a name="gtk-selection-data-get-format"></a><h3>gtk_selection_data_get_format ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_selection_data_get_format (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>);</pre>
<p>Retrieves the format of the selection.</p>
<div class="refsect3">
@ -2009,10 +2009,10 @@ gtk_selection_data_get_target (<em class="parameter"><code>const <a class="link"
<hr>
<div class="refsect2">
<a name="gtk-targets-include-image"></a><h3>gtk_targets_include_image ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_targets_include_image (<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> writable</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</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> writable</code></em>);</pre>
<p>Determines if any of the targets in <em class="parameter"><code>targets</code></em>
can be used to
provide 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>.</p>
@ -2047,18 +2047,18 @@ how to convert a pixbuf into the format</p></td>
</div>
<div class="refsect3">
<a name="gtk-targets-include-image.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>targets</code></em>
<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>targets</code></em>
include a suitable target for images,
otherwise <code class="literal">FALSE</code>.</p>
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-targets-include-text"></a><h3>gtk_targets_include_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_targets_include_text (<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);</pre>
<p>Determines if any of the targets in <em class="parameter"><code>targets</code></em>
can be used to
provide text.</p>
@ -2087,18 +2087,18 @@ provide text.</p>
</div>
<div class="refsect3">
<a name="gtk-targets-include-text.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>targets</code></em>
<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>targets</code></em>
include a suitable target for text,
otherwise <code class="literal">FALSE</code>.</p>
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-targets-include-uri"></a><h3>gtk_targets_include_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_targets_include_uri (<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);</pre>
<p>Determines if any of the targets in <em class="parameter"><code>targets</code></em>
can be used to
provide an uri list.</p>
@ -2127,18 +2127,18 @@ provide an uri list.</p>
</div>
<div class="refsect3">
<a name="gtk-targets-include-uri.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>targets</code></em>
<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>targets</code></em>
include a suitable target for uri lists,
otherwise <code class="literal">FALSE</code>.</p>
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-targets-include-rich-text"></a><h3>gtk_targets_include_rich_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_targets_include_rich_text (<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *targets</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_targets</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> n_targets</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
<p>Determines if any of the targets in <em class="parameter"><code>targets</code></em>
can be used to
@ -2173,9 +2173,9 @@ provide rich text.</p>
</div>
<div class="refsect3">
<a name="gtk-targets-include-rich-text.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>targets</code></em>
<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>targets</code></em>
include a suitable target for rich text,
otherwise <code class="literal">FALSE</code>.</p>
otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
<p class="since">Since: 2.10</p>
</div>
@ -2283,17 +2283,17 @@ or for supplied or received during drag-and-drop.</p>
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkTargetEntry.target"></a>target</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkTargetEntry.target"></a>target</code></em>;</p></td>
<td class="struct_member_description"><p>a string representation of the target type</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="GtkTargetEntry.flags"></a>flags</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkTargetEntry.flags"></a>flags</code></em>;</p></td>
<td class="struct_member_description"><p><a class="link" href="gtk3-Drag-and-Drop.html#GtkTargetFlags" title="enum GtkTargetFlags"><span class="type">GtkTargetFlags</span></a> for DND</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="GtkTargetEntry.info"></a>info</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkTargetEntry.info"></a>info</code></em>;</p></td>
<td class="struct_member_description"><p>an application-assigned integer ID which will
get passed as a parameter to e.g the <a class="link" href="GtkWidget.html#GtkWidget-selection-get" title="The “selection-get” signal"><span class="type">“selection-get”</span></a>
signal. It allows the application to identify the target
@ -2339,12 +2339,12 @@ an efficient form.</p>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="GtkTargetPair.flags"></a>flags</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkTargetPair.flags"></a>flags</code></em>;</p></td>
<td class="struct_member_description"><p><a class="link" href="gtk3-Drag-and-Drop.html#GtkTargetFlags" title="enum GtkTargetFlags"><span class="type">GtkTargetFlags</span></a> for DND</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><span class="type">guint</span> <em class="structfield"><code><a name="GtkTargetPair.info"></a>info</code></em>;</p></td>
<td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkTargetPair.info"></a>info</code></em>;</p></td>
<td class="struct_member_description"><p>an application-assigned integer ID which will
get passed as a parameter to e.g the <a class="link" href="GtkWidget.html#GtkWidget-selection-get" title="The “selection-get” signal"><span class="type">“selection-get”</span></a>
signal. It allows the application to identify the target