<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="gdk4-Clipboards">
<refmeta>
<refentrytitle role="top_of_page" id="gdk4-Clipboards.top_of_page">Clipboards</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GDK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Clipboards</refname>
<refpurpose>Share data between applications for Copy-and-Paste</refpurpose>
</refnamediv>

<refsect1 id="gdk4-Clipboards.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-get-display">gdk_clipboard_get_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkContentFormats"><returnvalue>GdkContentFormats</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-get-formats">gdk_clipboard_get_formats</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-is-local">gdk_clipboard_is_local</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkContentProvider"><returnvalue>GdkContentProvider</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-get-content">gdk_clipboard_get_content</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-store-async">gdk_clipboard_store_async</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-store-finish">gdk_clipboard_store_finish</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-async">gdk_clipboard_read_async</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GInputStream"><returnvalue>GInputStream</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-finish">gdk_clipboard_read_finish</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-value-async">gdk_clipboard_read_value_async</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="GValue"><returnvalue>GValue</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-value-finish">gdk_clipboard_read_value_finish</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-texture-async">gdk_clipboard_read_texture_async</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkTexture"><returnvalue>GdkTexture</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-texture-finish">gdk_clipboard_read_texture_finish</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-text-async">gdk_clipboard_read_text_async</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-clipboard-read-text-finish">gdk_clipboard_read_text_finish</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set-content">gdk_clipboard_set_content</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set">gdk_clipboard_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set-valist">gdk_clipboard_set_valist</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set-value">gdk_clipboard_set_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set-text">gdk_clipboard_set_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-clipboard-set-texture">gdk_clipboard_set_texture</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="gdk4-Clipboards.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="GdkContentProvider"><type>GdkContentProvider</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkClipboard--content">content</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GdkDisplay"><type>GdkDisplay</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkClipboard--display">display</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GdkContentFormats"><type>GdkContentFormats</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkClipboard--formats">formats</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GdkClipboard--local">local</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="gdk4-Clipboards.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkClipboard-changed">changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<anchor id="GdkClipboard"/><refsect1 id="gdk4-Clipboards.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GdkClipboard-struct">GdkClipboard</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="gdk4-Clipboards.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GdkClipboard
</screen>
</refsect1>

<refsect1 id="gdk4-Clipboards.includes"><title>Includes</title><synopsis>#include &lt;gdk/gdk.h&gt;
</synopsis></refsect1>

<refsect1 id="gdk4-Clipboards.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GdkClipboard"><type>GdkClipboard</type></link> object represents a clipboard of data shared
between different applications or between different parts of
the same application.</para>
<para>To get a GdkClipboard object, use <link linkend="gdk-display-get-clipboard"><function>gdk_display_get_clipboard()</function></link> or
<link linkend="gdk-display-get-primary-clipboard"><function>gdk_display_get_primary_clipboard()</function></link>. You can find out about the data that
is currently available in a clipboard using <link linkend="gdk-clipboard-get-formats"><function>gdk_clipboard_get_formats()</function></link>.</para>
<para>To make text or image data available in a clipboard, use <link linkend="gdk-clipboard-set-text"><function>gdk_clipboard_set_text()</function></link> or
<link linkend="gdk-clipboard-set-texture"><function>gdk_clipboard_set_texture()</function></link>. For other data, you can use <link linkend="gdk-clipboard-set-content"><function>gdk_clipboard_set_content()</function></link>,
which takes a <link linkend="GdkContentProvider"><type>GdkContentProvider</type></link> object.</para>
<para>To read textual or image data from a clipboard, use <link linkend="gdk-clipboard-read-text-async"><function>gdk_clipboard_read_text_async()</function></link> or
<link linkend="gdk-clipboard-read-texture-async"><function>gdk_clipboard_read_texture_async()</function></link>. For other data, use <link linkend="gdk-clipboard-read-async"><function>gdk_clipboard_read_async()</function></link>,
which provides a <link linkend="GInputStream"><type>GInputStream</type></link> object.</para>

</refsect1>
<refsect1 id="gdk4-Clipboards.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gdk-clipboard-get-display" role="function">
<title>gdk_clipboard_get_display&#160;()</title>
<indexterm zone="gdk-clipboard-get-display"><primary>gdk_clipboard_get_display</primary></indexterm>
<programlisting language="C"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
gdk_clipboard_get_display (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>);</programlisting>
<para>Gets the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> that the clipboard was created for.</para>
<refsect3 id="gdk-clipboard-get-display.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-get-display.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GdkDisplay"><type>GdkDisplay</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-get-formats" role="function">
<title>gdk_clipboard_get_formats&#160;()</title>
<indexterm zone="gdk-clipboard-get-formats"><primary>gdk_clipboard_get_formats</primary></indexterm>
<programlisting language="C"><link linkend="GdkContentFormats"><returnvalue>GdkContentFormats</returnvalue></link>&#160;*
gdk_clipboard_get_formats (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>);</programlisting>
<para>Gets the formats that the clipboard can provide its current contents in.</para>
<refsect3 id="gdk-clipboard-get-formats.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-get-formats.returns" role="returns">
<title>Returns</title>
<para>The formats of the clipboard. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-is-local" role="function">
<title>gdk_clipboard_is_local&#160;()</title>
<indexterm zone="gdk-clipboard-is-local"><primary>gdk_clipboard_is_local</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_clipboard_is_local (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>);</programlisting>
<para>Returns if the clipboard is local. A clipboard is considered local if it was
last claimed by the running application.</para>
<para>Note that <link linkend="gdk-clipboard-get-content"><function>gdk_clipboard_get_content()</function></link> may return <link linkend="NULL:CAPS"><literal>NULL</literal></link> even on a local
clipboard. In this case the clipboard is empty.</para>
<refsect3 id="gdk-clipboard-is-local.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-is-local.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the clipboard is local</para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-get-content" role="function">
<title>gdk_clipboard_get_content&#160;()</title>
<indexterm zone="gdk-clipboard-get-content"><primary>gdk_clipboard_get_content</primary></indexterm>
<programlisting language="C"><link linkend="GdkContentProvider"><returnvalue>GdkContentProvider</returnvalue></link>&#160;*
gdk_clipboard_get_content (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>);</programlisting>
<para>Returns the <link linkend="GdkContentProvider"><type>GdkContentProvider</type></link> currently set on <parameter>clipboard</parameter>
. If the
<parameter>clipboard</parameter>
 is empty or its contents are not owned by the current process,
<link linkend="NULL:CAPS"><literal>NULL</literal></link> will be returned.</para>
<refsect3 id="gdk-clipboard-get-content.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-get-content.returns" role="returns">
<title>Returns</title>
<para>The content of a clipboard or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
if the clipboard does not maintain any content. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-store-async" role="function">
<title>gdk_clipboard_store_async&#160;()</title>
<indexterm zone="gdk-clipboard-store-async"><primary>gdk_clipboard_store_async</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_store_async (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                           <parameter><link linkend="int"><type>int</type></link> io_priority</parameter>,
                           <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                           <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> callback</parameter>,
                           <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Asynchronously instructs the <parameter>clipboard</parameter>
 to store its contents remotely to
preserve them for later usage. If the clipboard is not local, this function
does nothing but report success.</para>
<para>This function is called automatically when <link linkend="gtk-main"><function>gtk_main()</function></link> or <link linkend="GtkApplication"><type>GtkApplication</type></link>
exit, so you likely don't need to call it.</para>
<refsect3 id="gdk-clipboard-store-async.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>io_priority</para></entry>
<entry role="parameter_description"><para>the <link linkend="io-priority">I/O priority</link>
of the request. </para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cancellable</para></entry>
<entry role="parameter_description"><para>optional <link linkend="GCancellable"><type>GCancellable</type></link> object, <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>callback to call when the request is satisfied. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>the data to pass to callback function. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-store-finish" role="function">
<title>gdk_clipboard_store_finish&#160;()</title>
<indexterm zone="gdk-clipboard-store-finish"><primary>gdk_clipboard_store_finish</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_clipboard_store_finish (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                            <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *result</parameter>,
                            <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Finishes an asynchronous clipboard store started with <link linkend="gdk-clipboard-store-async"><function>gdk_clipboard_store_async()</function></link>.</para>
<refsect3 id="gdk-clipboard-store-finish.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>result</para></entry>
<entry role="parameter_description"><para>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> location to store the error occurring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to
ignore.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-store-finish.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if storing was successful.</para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-async" role="function">
<title>gdk_clipboard_read_async&#160;()</title>
<indexterm zone="gdk-clipboard-read-async"><primary>gdk_clipboard_read_async</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_read_async (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                          <parameter>const <link linkend="char"><type>char</type></link> **mime_types</parameter>,
                          <parameter><link linkend="int"><type>int</type></link> io_priority</parameter>,
                          <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                          <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> callback</parameter>,
                          <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Asynchronously requests an input stream to read the <parameter>clipboard</parameter>
's
contents from. When the operation is finished <parameter>callback</parameter>
 will be called. 
You can then call <link linkend="gdk-clipboard-read-finish"><function>gdk_clipboard_read_finish()</function></link> to get the result of the 
operation.</para>
<para>The clipboard will choose the most suitable mime type from the given list
to fulfill the request, preferring the ones listed first.</para>
<refsect3 id="gdk-clipboard-read-async.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mime_types</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of mime types to choose from</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>io_priority</para></entry>
<entry role="parameter_description"><para>the <link linkend="io-priority">I/O priority</link>
of the request. </para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cancellable</para></entry>
<entry role="parameter_description"><para>optional <link linkend="GCancellable"><type>GCancellable</type></link> object, <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>callback to call when the request is satisfied. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>the data to pass to callback function. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-finish" role="function">
<title>gdk_clipboard_read_finish&#160;()</title>
<indexterm zone="gdk-clipboard-read-finish"><primary>gdk_clipboard_read_finish</primary></indexterm>
<programlisting language="C"><link linkend="GInputStream"><returnvalue>GInputStream</returnvalue></link>&#160;*
gdk_clipboard_read_finish (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                           <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *result</parameter>,
                           <parameter>const <link linkend="char"><type>char</type></link> **out_mime_type</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Finishes an asynchronous clipboard read started with <link linkend="gdk-clipboard-read-async"><function>gdk_clipboard_read_async()</function></link>.</para>
<refsect3 id="gdk-clipboard-read-finish.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>result</para></entry>
<entry role="parameter_description"><para>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>out_mime_type</para></entry>
<entry role="parameter_description"><para>pointer to store
the chosen mime type in or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>][<acronym>transfer none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> location to store the error occurring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to
ignore.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-read-finish.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GInputStream"><type>GInputStream</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> on error. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-value-async" role="function">
<title>gdk_clipboard_read_value_async&#160;()</title>
<indexterm zone="gdk-clipboard-read-value-async"><primary>gdk_clipboard_read_value_async</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_read_value_async (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                                <parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                                <parameter><link linkend="int"><type>int</type></link> io_priority</parameter>,
                                <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> callback</parameter>,
                                <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Asynchronously request the <parameter>clipboard</parameter>
 contents converted to the given
<parameter>type</parameter>
. When the operation is finished <parameter>callback</parameter>
 will be called. 
You can then call <link linkend="gdk-clipboard-read-value-finish"><function>gdk_clipboard_read_value_finish()</function></link> to get the resulting
<link linkend="GValue"><type>GValue</type></link>.</para>
<para>For local clipboard contents that are available in the given <link linkend="GType"><type>GType</type></link>, the
value will be copied directly. Otherwise, GDK will try to use
<link linkend="gdk-content-deserialize-async"><function>gdk_content_deserialize_async()</function></link> to convert the clipboard's data.</para>
<refsect3 id="gdk-clipboard-read-value-async.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GType"><type>GType</type></link> to read</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>io_priority</para></entry>
<entry role="parameter_description"><para>the <link linkend="io-priority">I/O priority</link>
of the request. </para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cancellable</para></entry>
<entry role="parameter_description"><para>optional <link linkend="GCancellable"><type>GCancellable</type></link> object, <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>callback to call when the request is satisfied. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>the data to pass to callback function. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-value-finish" role="function">
<title>gdk_clipboard_read_value_finish&#160;()</title>
<indexterm zone="gdk-clipboard-read-value-finish"><primary>gdk_clipboard_read_value_finish</primary></indexterm>
<programlisting language="C">const <link linkend="GValue"><returnvalue>GValue</returnvalue></link>&#160;*
gdk_clipboard_read_value_finish (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                                 <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *result</parameter>,
                                 <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Finishes an asynchronous clipboard read started with
<link linkend="gdk-clipboard-read-value-async"><function>gdk_clipboard_read_value_async()</function></link>.</para>
<refsect3 id="gdk-clipboard-read-value-finish.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>result</para></entry>
<entry role="parameter_description"><para>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> location to store the error occurring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to
ignore.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-read-value-finish.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GValue"><type>GValue</type></link> containing the result. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-texture-async" role="function">
<title>gdk_clipboard_read_texture_async&#160;()</title>
<indexterm zone="gdk-clipboard-read-texture-async"><primary>gdk_clipboard_read_texture_async</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_read_texture_async (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                                  <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                                  <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> callback</parameter>,
                                  <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Asynchronously request the <parameter>clipboard</parameter>
 contents converted to a <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link>.
When the operation is finished <parameter>callback</parameter>
 will be called. You can then
call <link linkend="gdk-clipboard-read-texture-finish"><function>gdk_clipboard_read_texture_finish()</function></link> to get the result.</para>
<para>This is a simple wrapper around <link linkend="gdk-clipboard-read-value-async"><function>gdk_clipboard_read_value_async()</function></link>. Use
that function or <link linkend="gdk-clipboard-read-async"><function>gdk_clipboard_read_async()</function></link> directly if you need more
control over the operation.</para>
<refsect3 id="gdk-clipboard-read-texture-async.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cancellable</para></entry>
<entry role="parameter_description"><para>optional <link linkend="GCancellable"><type>GCancellable</type></link> object, <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>callback to call when the request is satisfied. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>the data to pass to callback function. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-texture-finish" role="function">
<title>gdk_clipboard_read_texture_finish&#160;()</title>
<indexterm zone="gdk-clipboard-read-texture-finish"><primary>gdk_clipboard_read_texture_finish</primary></indexterm>
<programlisting language="C"><link linkend="GdkTexture"><returnvalue>GdkTexture</returnvalue></link>&#160;*
gdk_clipboard_read_texture_finish (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                                   <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *result</parameter>,
                                   <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Finishes an asynchronous clipboard read started with
<link linkend="gdk-clipboard-read-texture-async"><function>gdk_clipboard_read_texture_async()</function></link>.</para>
<refsect3 id="gdk-clipboard-read-texture-finish.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>result</para></entry>
<entry role="parameter_description"><para>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> location to store the error occurring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to
ignore.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-read-texture-finish.returns" role="returns">
<title>Returns</title>
<para>a new <link linkend="GdkTexture"><type>GdkTexture</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> on error. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-text-async" role="function">
<title>gdk_clipboard_read_text_async&#160;()</title>
<indexterm zone="gdk-clipboard-read-text-async"><primary>gdk_clipboard_read_text_async</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_read_text_async (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                               <parameter><link linkend="GCancellable"><type>GCancellable</type></link> *cancellable</parameter>,
                               <parameter><link linkend="GAsyncReadyCallback"><type>GAsyncReadyCallback</type></link> callback</parameter>,
                               <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Asynchronously request the <parameter>clipboard</parameter>
 contents converted to a string.
When the operation is finished <parameter>callback</parameter>
 will be called. You can then
call <link linkend="gdk-clipboard-read-text-finish"><function>gdk_clipboard_read_text_finish()</function></link> to get the result.</para>
<para>This is a simple wrapper around <link linkend="gdk-clipboard-read-value-async"><function>gdk_clipboard_read_value_async()</function></link>. Use
that function or <link linkend="gdk-clipboard-read-async"><function>gdk_clipboard_read_async()</function></link> directly if you need more
control over the operation.</para>
<refsect3 id="gdk-clipboard-read-text-async.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cancellable</para></entry>
<entry role="parameter_description"><para>optional <link linkend="GCancellable"><type>GCancellable</type></link> object, <link linkend="NULL:CAPS"><literal>NULL</literal></link> to ignore. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>callback to call when the request is satisfied. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>the data to pass to callback function. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-read-text-finish" role="function">
<title>gdk_clipboard_read_text_finish&#160;()</title>
<indexterm zone="gdk-clipboard-read-text-finish"><primary>gdk_clipboard_read_text_finish</primary></indexterm>
<programlisting language="C"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gdk_clipboard_read_text_finish (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                                <parameter><link linkend="GAsyncResult"><type>GAsyncResult</type></link> *result</parameter>,
                                <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Finishes an asynchronous clipboard read started with
<link linkend="gdk-clipboard-read-text-async"><function>gdk_clipboard_read_text_async()</function></link>.</para>
<refsect3 id="gdk-clipboard-read-text-finish.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>result</para></entry>
<entry role="parameter_description"><para>a <link linkend="GAsyncResult"><type>GAsyncResult</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>a <link linkend="GError"><type>GError</type></link> location to store the error occurring, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to
ignore.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-read-text-finish.returns" role="returns">
<title>Returns</title>
<para>a new string or <link linkend="NULL:CAPS"><literal>NULL</literal></link> on error. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set-content" role="function">
<title>gdk_clipboard_set_content&#160;()</title>
<indexterm zone="gdk-clipboard-set-content"><primary>gdk_clipboard_set_content</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_clipboard_set_content (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                           <parameter><link linkend="GdkContentProvider"><type>GdkContentProvider</type></link> *provider</parameter>);</programlisting>
<para>Sets a new content provider on <parameter>clipboard</parameter>
. The clipboard will claim the
<link linkend="GdkDisplay"><type>GdkDisplay</type></link>'s resources and advertise these new contents to other
applications.</para>
<para>In the rare case of a failure, this function will return <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>. The
clipboard will then continue reporting its old contents and ignore
<parameter>provider</parameter>
.</para>
<para>If the contents are read by either an external application or the
<parameter>clipboard</parameter>
's read functions, <parameter>clipboard</parameter>
 will select the best format to
transfer the contents and then request that format from <parameter>provider</parameter>
.</para>
<refsect3 id="gdk-clipboard-set-content.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>provider</para></entry>
<entry role="parameter_description"><para>the new contents of <parameter>clipboard</parameter>
or
<link linkend="NULL:CAPS"><literal>NULL</literal></link> to clear the clipboard. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-clipboard-set-content.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if setting the clipboard succeeded</para>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set" role="function">
<title>gdk_clipboard_set&#160;()</title>
<indexterm zone="gdk-clipboard-set"><primary>gdk_clipboard_set</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_set (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                   <parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                   <parameter>...</parameter>);</programlisting>
<para>Sets the clipboard to contain the value collected from the given
varargs.</para>
<refsect3 id="gdk-clipboard-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>type of value to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>value contents conforming to <parameter>type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set-valist" role="function">
<title>gdk_clipboard_set_valist&#160;()</title>
<indexterm zone="gdk-clipboard-set-valist"><primary>gdk_clipboard_set_valist</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_set_valist (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                          <parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                          <parameter><link linkend="va-list"><type>va_list</type></link> args</parameter>);</programlisting>
<para>Sets the clipboard to contain the value collected from the given
<parameter>args</parameter>
.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gdk-clipboard-set-valist.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>type of value to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>args</para></entry>
<entry role="parameter_description"><para>varargs containing the value of <parameter>type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set-value" role="function">
<title>gdk_clipboard_set_value&#160;()</title>
<indexterm zone="gdk-clipboard-set-value"><primary>gdk_clipboard_set_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_set_value (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                         <parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Sets the <parameter>clipboard</parameter>
 to contain the given <parameter>value</parameter>
.</para>

<para><emphasis role="annotation">[<acronym>rename-to</acronym> gdk_clipboard_set]</emphasis></para><refsect3 id="gdk-clipboard-set-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a <link linkend="GValue"><type>GValue</type></link> to set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set-text" role="function">
<title>gdk_clipboard_set_text&#160;()</title>
<indexterm zone="gdk-clipboard-set-text"><primary>gdk_clipboard_set_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_set_text (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                        <parameter>const <link linkend="char"><type>char</type></link> *text</parameter>);</programlisting>
<para>Puts the given <parameter>text</parameter>
 into the clipboard.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gdk-clipboard-set-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>Text to put into the clipboard</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-clipboard-set-texture" role="function">
<title>gdk_clipboard_set_texture&#160;()</title>
<indexterm zone="gdk-clipboard-set-texture"><primary>gdk_clipboard_set_texture</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_clipboard_set_texture (<parameter><link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard</parameter>,
                           <parameter><link linkend="GdkTexture"><type>GdkTexture</type></link> *texture</parameter>);</programlisting>
<para>Puts the given <parameter>texture</parameter>
 into the clipboard.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gdk-clipboard-set-texture.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkClipboard"><type>GdkClipboard</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>texture</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkTexture"><type>GdkTexture</type></link> to put into the clipboard</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="gdk4-Clipboards.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GdkClipboard-struct" role="struct">
<title>GdkClipboard</title>
<indexterm zone="GdkClipboard-struct"><primary>GdkClipboard</primary></indexterm>
<programlisting language="C">typedef struct _GdkClipboard GdkClipboard;</programlisting>
<para>The GdkClipboard struct contains only private fields and should not be
accessed directly.</para>
</refsect2>

</refsect1>
<refsect1 id="gdk4-Clipboards.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GdkClipboard--content" role="property"><title>The <literal>“content”</literal> property</title>
<indexterm zone="GdkClipboard--content"><primary>GdkClipboard:content</primary></indexterm>
<programlisting>  “content”                  <link linkend="GdkContentProvider"><type>GdkContentProvider</type></link>&#160;*</programlisting>
<para>The <link linkend="GdkContentProvider"><type>GdkContentProvider</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the clipboard is empty or contents are
provided otherwise.</para>
<para>Owner: GdkClipboard</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GdkClipboard--display" role="property"><title>The <literal>“display”</literal> property</title>
<indexterm zone="GdkClipboard--display"><primary>GdkClipboard:display</primary></indexterm>
<programlisting>  “display”                  <link linkend="GdkDisplay"><type>GdkDisplay</type></link>&#160;*</programlisting>
<para>The <link linkend="GdkDisplay"><type>GdkDisplay</type></link> that the clipboard belongs to.</para>
<para>Owner: GdkClipboard</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GdkClipboard--formats" role="property"><title>The <literal>“formats”</literal> property</title>
<indexterm zone="GdkClipboard--formats"><primary>GdkClipboard:formats</primary></indexterm>
<programlisting>  “formats”                  <link linkend="GdkContentFormats"><type>GdkContentFormats</type></link>&#160;*</programlisting>
<para>The possible formats that the clipboard can provide its data in.</para>
<para>Owner: GdkClipboard</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GdkClipboard--local" role="property"><title>The <literal>“local”</literal> property</title>
<indexterm zone="GdkClipboard--local"><primary>GdkClipboard:local</primary></indexterm>
<programlisting>  “local”                    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the contents of the clipboard are owned by this process.</para>
<para>Owner: GdkClipboard</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>

</refsect1>
<refsect1 id="gdk4-Clipboards.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GdkClipboard-changed" role="signal"><title>The <literal>“changed”</literal> signal</title>
<indexterm zone="GdkClipboard-changed"><primary>GdkClipboard::changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkClipboard"><type>GdkClipboard</type></link> *clipboard,
               <link linkend="gpointer"><type>gpointer</type></link>      user_data)</programlisting>
<para>The ::changed signal is emitted when the clipboard changes ownership.</para>
<refsect3 id="GdkClipboard-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>clipboard</para></entry>
<entry role="parameter_description"><para>the object on which the signal was emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>
<refsect1 id="gdk4-Clipboards.see-also">
<title>See Also</title>
<para><link linkend="GdkContentProvider"><type>GdkContentProvider</type></link>, <link linkend="GdkContentFormats"><type>GdkContentFormats</type></link></para>

</refsect1>

</refentry>
