New upstream version 3.24.18

This commit is contained in:
Simon McVittie
2020-04-10 15:23:16 +01:00
386 changed files with 78008 additions and 6390 deletions

View File

@ -43,7 +43,7 @@ via selections</p>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">GtkTargetEntry</span> *
<a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-target-entry-new" title="gtk_target_entry_new ()">gtk_target_entry_new</a> <span class="c_punctuation">()</span>
@ -51,7 +51,7 @@ via selections</p>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GtkTargetEntry</span> *
<a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-target-entry-copy" title="gtk_target_entry_copy ()">gtk_target_entry_copy</a> <span class="c_punctuation">()</span>
@ -163,7 +163,7 @@ via selections</p>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GtkTargetEntry</span> *
<a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-Selections.html#gtk-target-table-new-from-list" title="gtk_target_table_new_from_list ()">gtk_target_table_new_from_list</a> <span class="c_punctuation">()</span>
@ -444,19 +444,19 @@ via selections</p>
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct">GtkSelectionData</a></td>
<td class="function_name"><a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData">GtkSelectionData</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name">GtkTargetEntry</td>
<td class="function_name"><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry">GtkTargetEntry</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name">GtkTargetList</td>
<td class="function_name"><a class="link" href="gtk3-Selections.html#GtkTargetList-struct" title="GtkTargetList">GtkTargetList</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name">GtkTargetPair</td>
<td class="function_name"><a class="link" href="gtk3-Selections.html#GtkTargetPair" title="struct GtkTargetPair">GtkTargetPair</a></td>
</tr>
</tbody>
</table></div>
@ -488,7 +488,7 @@ and <a class="link" href="gtk3-Selections.html#gtk-selection-data-set-pixbuf" ti
which is one of the reasons why it is advised to use <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a>.</p>
<p>Some of the datatypes defined this section are used in
the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> and drag-and-drop APIs as well. The
<span class="type">GtkTargetEntry</span> and <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> objects represent
<a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> and <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> objects represent
lists of data types that are supported when sending or
receiving data. The <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object is used to
store a chunk of data along with the data type and other
@ -498,11 +498,11 @@ associated information.</p>
<a name="gtk3-Selections.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-target-entry-new"></a><h3>gtk_target_entry_new ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkTargetEntry</span> *
<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>
<p>Makes a new <span class="type">GtkTargetEntry</span>.</p>
<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>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -519,7 +519,7 @@ gtk_target_entry_new (<em class="parameter"><code>const <span class="type">gchar
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p>Set of flags, see <span class="type">GtkTargetFlags</span></p></td>
<td class="parameter_description"><p>Set of flags, see <a class="link" href="gtk3-Drag-and-Drop.html#GtkTargetFlags" title="enum GtkTargetFlags"><span class="type">GtkTargetFlags</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -532,16 +532,16 @@ gtk_target_entry_new (<em class="parameter"><code>const <span class="type">gchar
</div>
<div class="refsect3">
<a name="gtk-target-entry-new.returns"></a><h4>Returns</h4>
<p> a pointer to a new <span class="type">GtkTargetEntry</span>.
<p> a pointer to a new <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>.
Free with <a class="link" href="gtk3-Selections.html#gtk-target-entry-free" title="gtk_target_entry_free ()"><code class="function">gtk_target_entry_free()</code></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-target-entry-copy"></a><h3>gtk_target_entry_copy ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkTargetEntry</span> *
gtk_target_entry_copy (<em class="parameter"><code><span class="type">GtkTargetEntry</span> *data</code></em>);</pre>
<p>Makes a copy of a <span class="type">GtkTargetEntry</span> and its data.</p>
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="returnvalue">GtkTargetEntry</span></a> *
gtk_target_entry_copy (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *data</code></em>);</pre>
<p>Makes a copy of a <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> and its data.</p>
<div class="refsect3">
<a name="gtk-target-entry-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -552,7 +552,7 @@ gtk_target_entry_copy (<em class="parameter"><code><span class="type">GtkTargetE
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>a pointer to a <span class="type">GtkTargetEntry</span></p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -568,8 +568,8 @@ Free with <a class="link" href="gtk3-Selections.html#gtk-target-entry-free" titl
<div class="refsect2">
<a name="gtk-target-entry-free"></a><h3>gtk_target_entry_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_target_entry_free (<em class="parameter"><code><span class="type">GtkTargetEntry</span> *data</code></em>);</pre>
<p>Frees a <span class="type">GtkTargetEntry</span> returned from
gtk_target_entry_free (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *data</code></em>);</pre>
<p>Frees a <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> returned from
<a class="link" href="gtk3-Selections.html#gtk-target-entry-new" title="gtk_target_entry_new ()"><code class="function">gtk_target_entry_new()</code></a> or <a class="link" href="gtk3-Selections.html#gtk-target-entry-copy" title="gtk_target_entry_copy ()"><code class="function">gtk_target_entry_copy()</code></a>.</p>
<div class="refsect3">
<a name="gtk-target-entry-free.parameters"></a><h4>Parameters</h4>
@ -581,7 +581,7 @@ gtk_target_entry_free (<em class="parameter"><code><span class="type">GtkTargetE
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>a pointer to a <span class="type">GtkTargetEntry</span>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -591,9 +591,9 @@ gtk_target_entry_free (<em class="parameter"><code><span class="type">GtkTargetE
<div class="refsect2">
<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 <span class="type">GtkTargetEntry</span> *targets</code></em>,
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>
<p>Creates a new <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> from an array of <span class="type">GtkTargetEntry</span>.</p>
<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>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -606,7 +606,7 @@ gtk_target_list_new (<em class="parameter"><code>const <span class="type">GtkTar
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>Pointer to an array
of <span class="type">GtkTargetEntry</span>. </p></td>
of <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=ntargets][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
@ -720,9 +720,9 @@ gtk_target_list_add (<em class="parameter"><code><a class="link" href="gtk3-Sele
<a name="gtk-target-list-add-table"></a><h3>gtk_target_list_add_table ()</h3>
<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 <span class="type">GtkTargetEntry</span> *targets</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>
<p>Prepends a table of <span class="type">GtkTargetEntry</span> to a target list.</p>
<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>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -739,7 +739,7 @@ gtk_target_list_add_table (<em class="parameter"><code><a class="link" href="gtk
</tr>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>the table of <span class="type">GtkTargetEntry</span>. </p></td>
<td class="parameter_description"><p>the table of <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=ntargets]</span></td>
</tr>
<tr>
@ -980,7 +980,7 @@ application info for target, or <code class="literal">NULL</code>. </p></td>
<div class="refsect2">
<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><span class="type">GtkTargetEntry</span> *targets</code></em>,
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>
<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>
@ -995,7 +995,7 @@ gtk_target_table_free (<em class="parameter"><code><span class="type">GtkTargetE
<tbody>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>a <span class="type">GtkTargetEntry</span> array. </p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> array. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_targets]</span></td>
</tr>
<tr>
@ -1011,10 +1011,10 @@ gtk_target_table_free (<em class="parameter"><code><span class="type">GtkTargetE
<hr>
<div class="refsect2">
<a name="gtk-target-table-new-from-list"></a><h3>gtk_target_table_new_from_list ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkTargetEntry</span> *
<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>
<p>This function creates an <span class="type">GtkTargetEntry</span> array that contains the
<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
longer needed.</p>
@ -1187,7 +1187,7 @@ given widget and selection.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
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><span class="type">GdkAtom</span> selection</code></em>,
<em class="parameter"><code>const <span class="type">GtkTargetEntry</span> *targets</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>
<p>Prepends a table of targets to the list of supported targets
for a given widget and selection.</p>
@ -1329,7 +1329,7 @@ Zero-terminates the stored data.</p>
<tbody>
<tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1788,7 +1788,7 @@ gtk_selection_data_get_selection (<em class="parameter"><code>const <a class="li
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1818,7 +1818,7 @@ gtk_selection_data_get_data (<em class="parameter"><code>const <a class="link" h
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a
<a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1846,7 +1846,7 @@ gtk_selection_data_get_length (<em class="parameter"><code>const <a class="link"
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1877,7 +1877,7 @@ gtk_selection_data_get_data_with_length
<tbody>
<tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -1911,7 +1911,7 @@ gtk_selection_data_get_data_type (<em class="parameter"><code>const <a class="li
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1939,7 +1939,7 @@ gtk_selection_data_get_display (<em class="parameter"><code>const <a class="link
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1967,7 +1967,7 @@ gtk_selection_data_get_format (<em class="parameter"><code>const <a class="link"
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -1994,7 +1994,7 @@ gtk_selection_data_get_target (<em class="parameter"><code>const <a class="link"
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>selection_data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -2209,7 +2209,7 @@ called by applications.</p>
<a name="gtk-selection-data-copy"></a><h3>gtk_selection_data_copy ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="returnvalue">GtkSelectionData</span></a> *
gtk_selection_data_copy (<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *data</code></em>);</pre>
<p>Makes a copy of a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a> and its data.</p>
<p>Makes a copy of a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> and its data.</p>
<div class="refsect3">
<a name="gtk-selection-data-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -2220,7 +2220,7 @@ gtk_selection_data_copy (<em class="parameter"><code>const <a class="link" href=
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -2236,7 +2236,7 @@ gtk_selection_data_copy (<em class="parameter"><code>const <a class="link" href=
<a name="gtk-selection-data-free"></a><h3>gtk_selection_data_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_selection_data_free (<em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *data</code></em>);</pre>
<p>Frees a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a> returned from
<p>Frees a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> returned from
<a class="link" href="gtk3-Selections.html#gtk-selection-data-copy" title="gtk_selection_data_copy ()"><code class="function">gtk_selection_data_copy()</code></a>.</p>
<div class="refsect3">
<a name="gtk-selection-data-free.parameters"></a><h4>Parameters</h4>
@ -2248,7 +2248,7 @@ gtk_selection_data_free (<em class="parameter"><code><a class="link" href="gtk3-
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>a pointer to a <a href="https://developer.gnome.org/gtk4/gtk4-Selections.html#GtkSelectionData-struct"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="gtk3-Selections.html#GtkSelectionData-struct" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
@ -2256,6 +2256,107 @@ gtk_selection_data_free (<em class="parameter"><code><a class="link" href="gtk3-
</div>
</div>
<div class="refsect1">
<a name="gtk3-Selections.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkSelectionData-struct"></a><h3>GtkSelectionData</h3>
<pre class="programlisting">typedef struct _GtkSelectionData GtkSelectionData;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkTargetEntry"></a><h3>struct GtkTargetEntry</h3>
<pre class="programlisting">struct GtkTargetEntry {
gchar *target;
guint flags;
guint info;
};
</pre>
<p>A <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> represents a single type of
data than can be supplied for by a widget for a selection
or for supplied or received during drag-and-drop.</p>
<div class="refsect3">
<a name="GtkTargetEntry.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</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_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_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_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
type without extensive string compares.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkTargetList-struct"></a><h3>GtkTargetList</h3>
<pre class="programlisting">typedef struct _GtkTargetList GtkTargetList;</pre>
<p>A <a class="link" href="gtk3-Selections.html#GtkTargetList-struct" title="GtkTargetList"><span class="type">GtkTargetList</span></a> is a reference counted list
of <a class="link" href="gtk3-Selections.html#GtkTargetPair" title="struct GtkTargetPair"><span class="type">GtkTargetPair</span></a> and should be treated as
opaque.</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTargetPair"></a><h3>struct GtkTargetPair</h3>
<pre class="programlisting">struct GtkTargetPair {
GdkAtom target;
guint flags;
guint info;
};
</pre>
<p>A <a class="link" href="gtk3-Selections.html#GtkTargetPair" title="struct GtkTargetPair"><span class="type">GtkTargetPair</span></a> is used to represent the same
information as a table of <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>, but in
an efficient form.</p>
<div class="refsect3">
<a name="GtkTargetPair.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><span class="type">GdkAtom</span> <em class="structfield"><code><a name="GtkTargetPair.target"></a>target</code></em>;</p></td>
<td class="struct_member_description"><p><span class="type">GdkAtom</span> 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="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_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
type without extensive string compares.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="gtk3-Selections.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> - Much of the operation of selections happens via
signals for <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>. In particular, if you are using the functions