New upstream version 3.22.28

This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
652 changed files with 498643 additions and 49781 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="reference.html" title="API Reference">
<link rel="prev" href="gdk3-Keyboard-Handling.html" title="Key Values">
<link rel="next" href="gdk3-Drag-and-Drop.html" title="Drag And Drop">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -41,7 +41,7 @@
<tbody>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="gdk3-Selections.html#gdk-selection-owner-set" title="gdk_selection_owner_set ()">gdk_selection_owner_set</a> <span class="c_punctuation">()</span>
@ -49,7 +49,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="gdk3-Selections.html#gdk-selection-owner-set-for-display" title="gdk_selection_owner_set_for_display ()">gdk_selection_owner_set_for_display</a> <span class="c_punctuation">()</span>
@ -81,7 +81,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="gdk3-Selections.html#gdk-selection-property-get" title="gdk_selection_property_get ()">gdk_selection_property_get</a> <span class="c_punctuation">()</span>
@ -214,11 +214,11 @@ X Inter-client Communication Conventions Manual (ICCCM).</p>
<a name="gdk3-Selections.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gdk-selection-owner-set"></a><h3>gdk_selection_owner_set ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gdk_selection_owner_set (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> send_event</code></em>);</pre>
<p>Sets the owner of the given selection.</p>
<div class="refsect3">
<a name="gdk-selection-owner-set.parameters"></a><h4>Parameters</h4>
@ -231,7 +231,7 @@ gdk_selection_owner_set (<em class="parameter"><code><a class="link" href="gdk3-
<tbody>
<tr>
<td class="parameter_name"><p>owner</p></td>
<td class="parameter_description"><p> a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <code class="literal">NULL</code> to indicate that the
the owner for the given should be unset. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -250,7 +250,7 @@ request will be ignored.</p></td>
</tr>
<tr>
<td class="parameter_name"><p>send_event</p></td>
<td class="parameter_description"><p>if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different
<td class="parameter_description"><p>if <code class="literal">TRUE</code>, and the new owner is different
from the current owner, the current owner
will be sent a SelectionClear event.</p></td>
<td class="parameter_annotations"> </td>
@ -260,20 +260,20 @@ will be sent a SelectionClear event.</p></td>
</div>
<div class="refsect3">
<a name="gdk-selection-owner-set.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection owner was successfully
<p> <code class="literal">TRUE</code> if the selection owner was successfully
changed to <em class="parameter"><code>owner</code></em>
, otherwise <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
, otherwise <code class="literal">FALSE</code>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-selection-owner-set-for-display"></a><h3>gdk_selection_owner_set_for_display ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gdk_selection_owner_set_for_display (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> send_event</code></em>);</pre>
<p>Sets the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> <em class="parameter"><code>owner</code></em>
as the current owner of the selection <em class="parameter"><code>selection</code></em>
.</p>
@ -293,7 +293,7 @@ gdk_selection_owner_set_for_display (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>owner</p></td>
<td class="parameter_description"><p> a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that the owner for
<td class="parameter_description"><p>a <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> or <code class="literal">NULL</code> to indicate that the owner for
the given should be unset. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
@ -311,7 +311,7 @@ set for the given selection, the request will be ignored</p></td>
</tr>
<tr>
<td class="parameter_name"><p>send_event</p></td>
<td class="parameter_description"><p>if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different from the current
<td class="parameter_description"><p>if <code class="literal">TRUE</code>, and the new owner is different from the current
owner, the current owner will be sent a SelectionClear event</p></td>
<td class="parameter_annotations"> </td>
</tr>
@ -320,8 +320,8 @@ owner, the current owner will be sent a SelectionClear event</p></td>
</div>
<div class="refsect3">
<a name="gdk-selection-owner-set-for-display.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection owner was successfully changed to owner,
otherwise <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<p> <code class="literal">TRUE</code> if the selection owner was successfully changed to owner,
otherwise <code class="literal">FALSE</code>.</p>
</div>
<p class="since">Since: 2.2</p>
</div>
@ -348,9 +348,9 @@ gdk_selection_owner_get (<em class="parameter"><code><a class="link" href="gdk3-
</div>
<div class="refsect3">
<a name="gdk-selection-owner-get.returns"></a><h4>Returns</h4>
<p> if there is a selection owner
<p>if there is a selection owner
for this window, and it is a window known to the current process,
the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note
the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise <code class="literal">NULL</code>. Note
that the return value may be owned by a different process if a
foreign window was previously created for that window, but a new
foreign window will never be created by this call. </p>
@ -391,10 +391,10 @@ window, but a new foreign window will never be created by this call.</p>
</div>
<div class="refsect3">
<a name="gdk-selection-owner-get-for-display.returns"></a><h4>Returns</h4>
<p> if there is a selection owner
<p>if there is a selection owner
for this window, and it is a window known to the current
process, the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.2</p>
@ -406,7 +406,7 @@ process, the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="typ
gdk_selection_convert (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Retrieves the contents of a selection in a given
form.</p>
<div class="refsect3">
@ -449,14 +449,14 @@ the time indicated by the timestamp.</p></td>
<hr>
<div class="refsect2">
<a name="gdk-selection-property-get"></a><h3>gdk_selection_property_get ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_selection_property_get (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **data</code></em>,
<em class="parameter"><code><span class="type">guchar</span> **data</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *prop_type</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *prop_format</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *prop_format</code></em>);</pre>
<p>Retrieves selection data that was stored by the selection
data in response to a call to <a class="link" href="gdk3-Selections.html#gdk-selection-convert" title="gdk_selection_convert ()"><code class="function">gdk_selection_convert()</code></a>. This function
will not be used by applications, who should use the <a href="../gtk4/gtk4-Clipboards.html#GtkClipboard-struct"><span class="type">GtkClipboard</span></a>
will not be used by applications, who should use the <span class="type">GtkClipboard</span>
API instead.</p>
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
<div class="refsect3">
@ -476,8 +476,8 @@ API instead.</p>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>location to store a pointer to the retrieved data.
If the retrieval failed, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> we be stored here, otherwise, it
will be non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and the returned data should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
If the retrieval failed, <code class="literal">NULL</code> we be stored here, otherwise, it
will be non-<code class="literal">NULL</code> and the returned data should be freed with <code class="function">g_free()</code>
when you are finished using it. The length of the
allocated memory is one more than the length
of the returned data, and the final byte will always
@ -510,7 +510,7 @@ gdk_selection_send_notify (<em class="parameter"><code><a class="link" href="gdk
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Sends a response to SelectionRequest event.</p>
<div class="refsect3">
<a name="gdk-selection-send-notify.parameters"></a><h4>Parameters</h4>
@ -561,7 +561,7 @@ gdk_selection_send_notify_for_display (<em class="parameter"><code><a class="lin
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
<p>Send a response to SelectionRequest event.</p>
<div class="refsect3">
<a name="gdk-selection-send-notify-for-display.parameters"></a><h4>Parameters</h4>
@ -726,6 +726,6 @@ or <a class="link" href="gdk3-Properties-and-Atoms.html#GDK-NONE:CAPS" title="GD
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>