← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/gtk-Clipboards.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/gtk-Clipboards.html
47
47
                    <a class="link" href="gtk-Clipboards.html#GtkClipboard-struct" title="GtkClipboard">GtkClipboard</a>;
48
48
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardReceivedFunc" title="GtkClipboardReceivedFunc ()">*GtkClipboardReceivedFunc</a>)         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
49
49
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
50
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
50
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
51
51
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardTextReceivedFunc" title="GtkClipboardTextReceivedFunc ()">*GtkClipboardTextReceivedFunc</a>)     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
52
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
53
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
52
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
 
53
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
54
54
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardImageReceivedFunc" title="GtkClipboardImageReceivedFunc ()">*GtkClipboardImageReceivedFunc</a>)    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
55
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
56
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
57
57
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardTargetsReceivedFunc" title="GtkClipboardTargetsReceivedFunc ()">*GtkClipboardTargetsReceivedFunc</a>)  (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
58
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
59
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_atoms</code></em>,
60
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
58
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
 
59
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_atoms</code></em>,
 
60
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
61
61
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardRichTextReceivedFunc" title="GtkClipboardRichTextReceivedFunc ()">*GtkClipboardRichTextReceivedFunc</a>) (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
62
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
63
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *text</code></em>,
64
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
65
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
 
63
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *text</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
66
66
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardURIReceivedFunc" title="GtkClipboardURIReceivedFunc ()">*GtkClipboardURIReceivedFunc</a>)      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
67
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uris</code></em>,
68
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
67
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uris</code></em>,
 
68
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
69
69
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()">*GtkClipboardGetFunc</a>)              (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
70
70
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
71
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>,
72
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);
 
71
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>,
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);
73
73
<span class="returnvalue">void</span>                (<a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()">*GtkClipboardClearFunc</a>)            (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
74
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);
75
 
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get" title="gtk_clipboard_get ()">gtk_clipboard_get</a>                   (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
76
 
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-for-display" title="gtk_clipboard_get_for_display ()">gtk_clipboard_get_for_display</a>       (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
77
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
78
 
<a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="returnvalue">GdkDisplay</span></a> *        <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-display" title="gtk_clipboard_get_display ()">gtk_clipboard_get_display</a>           (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
79
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-data" title="gtk_clipboard_set_with_data ()">gtk_clipboard_set_with_data</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
80
 
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
81
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
82
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
83
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
84
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
85
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-owner" title="gtk_clipboard_set_with_owner ()">gtk_clipboard_set_with_owner</a>        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
86
 
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
87
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
88
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
89
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
90
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *owner</code></em>);
91
 
<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-owner" title="gtk_clipboard_get_owner ()">gtk_clipboard_get_owner</a>             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);
 
75
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get" title="gtk_clipboard_get ()">gtk_clipboard_get</a>                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
 
76
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-for-display" title="gtk_clipboard_get_for_display ()">gtk_clipboard_get_for_display</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
 
77
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
 
78
<a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="returnvalue">GdkDisplay</span></a> *        <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-display" title="gtk_clipboard_get_display ()">gtk_clipboard_get_display</a>           (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
79
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-data" title="gtk_clipboard_set_with_data ()">gtk_clipboard_set_with_data</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
80
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
 
82
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
 
83
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
 
84
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
85
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-owner" title="gtk_clipboard_set_with_owner ()">gtk_clipboard_set_with_owner</a>        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
86
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
 
87
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
 
88
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
 
89
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
 
90
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *owner</code></em>);
 
91
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-owner" title="gtk_clipboard_get_owner ()">gtk_clipboard_get_owner</a>             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
92
92
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-clear" title="gtk_clipboard_clear ()">gtk_clipboard_clear</a>                 (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
93
93
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-text" title="gtk_clipboard_set_text ()">gtk_clipboard_set_text</a>              (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
94
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
95
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);
 
94
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
 
95
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);
96
96
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-image" title="gtk_clipboard_set_image ()">gtk_clipboard_set_image</a>             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
97
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
 
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
98
98
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-contents" title="gtk_clipboard_request_contents ()">gtk_clipboard_request_contents</a>      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
99
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
 
99
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
100
100
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardReceivedFunc" title="GtkClipboardReceivedFunc ()"><span class="type">GtkClipboardReceivedFunc</span></a> callback</code></em>,
101
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
101
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
102
102
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-text" title="gtk_clipboard_request_text ()">gtk_clipboard_request_text</a>          (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
103
103
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardTextReceivedFunc" title="GtkClipboardTextReceivedFunc ()"><span class="type">GtkClipboardTextReceivedFunc</span></a> callback</code></em>,
104
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
104
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
105
105
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-image" title="gtk_clipboard_request_image ()">gtk_clipboard_request_image</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
106
106
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardImageReceivedFunc" title="GtkClipboardImageReceivedFunc ()"><span class="type">GtkClipboardImageReceivedFunc</span></a> callback</code></em>,
107
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
107
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
108
108
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-targets" title="gtk_clipboard_request_targets ()">gtk_clipboard_request_targets</a>       (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
109
109
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardTargetsReceivedFunc" title="GtkClipboardTargetsReceivedFunc ()"><span class="type">GtkClipboardTargetsReceivedFunc</span></a> callback</code></em>,
110
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
110
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
111
111
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-rich-text" title="gtk_clipboard_request_rich_text ()">gtk_clipboard_request_rich_text</a>     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
112
112
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
113
113
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardRichTextReceivedFunc" title="GtkClipboardRichTextReceivedFunc ()"><span class="type">GtkClipboardRichTextReceivedFunc</span></a> callback</code></em>,
114
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
114
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
115
115
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-uris" title="gtk_clipboard_request_uris ()">gtk_clipboard_request_uris</a>          (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
116
116
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardURIReceivedFunc" title="GtkClipboardURIReceivedFunc ()"><span class="type">GtkClipboardURIReceivedFunc</span></a> callback</code></em>,
117
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
117
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
118
118
<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="returnvalue">GtkSelectionData</span></a> *  <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-contents" title="gtk_clipboard_wait_for_contents ()">gtk_clipboard_wait_for_contents</a>     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
119
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
120
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-text" title="gtk_clipboard_wait_for_text ()">gtk_clipboard_wait_for_text</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
121
 
<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-image" title="gtk_clipboard_wait_for_image ()">gtk_clipboard_wait_for_image</a>        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
122
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-rich-text" title="gtk_clipboard_wait_for_rich_text ()">gtk_clipboard_wait_for_rich_text</a>    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
119
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
 
120
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-text" title="gtk_clipboard_wait_for_text ()">gtk_clipboard_wait_for_text</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
121
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-image" title="gtk_clipboard_wait_for_image ()">gtk_clipboard_wait_for_image</a>        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
122
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-rich-text" title="gtk_clipboard_wait_for_rich_text ()">gtk_clipboard_wait_for_rich_text</a>    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
123
123
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
124
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
125
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);
126
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-uris" title="gtk_clipboard_wait_for_uris ()">gtk_clipboard_wait_for_uris</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
127
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-text-available" title="gtk_clipboard_wait_is_text_available ()">gtk_clipboard_wait_is_text_available</a>
128
 
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
129
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-image-available" title="gtk_clipboard_wait_is_image_available ()">gtk_clipboard_wait_is_image_available</a>
130
 
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
131
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-rich-text-available" title="gtk_clipboard_wait_is_rich_text_available ()">gtk_clipboard_wait_is_rich_text_available</a>
 
124
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
 
125
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);
 
126
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-uris" title="gtk_clipboard_wait_for_uris ()">gtk_clipboard_wait_for_uris</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
127
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-text-available" title="gtk_clipboard_wait_is_text_available ()">gtk_clipboard_wait_is_text_available</a>
 
128
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
129
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-image-available" title="gtk_clipboard_wait_is_image_available ()">gtk_clipboard_wait_is_image_available</a>
 
130
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
 
131
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-rich-text-available" title="gtk_clipboard_wait_is_rich_text_available ()">gtk_clipboard_wait_is_rich_text_available</a>
132
132
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
133
133
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);
134
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-uris-available" title="gtk_clipboard_wait_is_uris_available ()">gtk_clipboard_wait_is_uris_available</a>
 
134
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-uris-available" title="gtk_clipboard_wait_is_uris_available ()">gtk_clipboard_wait_is_uris_available</a>
135
135
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
136
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-targets" title="gtk_clipboard_wait_for_targets ()">gtk_clipboard_wait_for_targets</a>      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
137
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
138
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_targets</code></em>);
139
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-target-available" title="gtk_clipboard_wait_is_target_available ()">gtk_clipboard_wait_is_target_available</a>
 
136
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-for-targets" title="gtk_clipboard_wait_for_targets ()">gtk_clipboard_wait_for_targets</a>      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
137
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
 
138
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_targets</code></em>);
 
139
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-Clipboards.html#gtk-clipboard-wait-is-target-available" title="gtk_clipboard_wait_is_target_available ()">gtk_clipboard_wait_is_target_available</a>
140
140
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
141
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
 
141
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
142
142
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-can-store" title="gtk_clipboard_set_can_store ()">gtk_clipboard_set_can_store</a>         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
143
143
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
144
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);
 
144
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);
145
145
<span class="returnvalue">void</span>                <a class="link" href="gtk-Clipboards.html#gtk-clipboard-store" title="gtk_clipboard_store ()">gtk_clipboard_store</a>                 (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);
146
146
</pre>
147
147
</div>
148
148
<div class="refsect1" title="Object Hierarchy">
149
149
<a name="gtk-Clipboards.object-hierarchy"></a><h2>Object Hierarchy</h2>
150
150
<pre class="synopsis">
151
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
151
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
152
152
   +----GtkClipboard
153
153
</pre>
154
154
</div>
164
164
    The <a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> object represents a clipboard of data shared
165
165
    between different processes or between different widgets in
166
166
    the same process. Each clipboard is identified by a name encoded as a
167
 
    <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a>. (Conversion to and from strings can be done with
168
 
    <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#gdk-atom-intern"><code class="function">gdk_atom_intern()</code></a> and <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#gdk-atom-name"><code class="function">gdk_atom_name()</code></a>.) The default clipboard
 
167
    <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a>. (Conversion to and from strings can be done with
 
168
    <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#gdk-atom-intern"><code class="function">gdk_atom_intern()</code></a> and <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#gdk-atom-name"><code class="function">gdk_atom_name()</code></a>.) The default clipboard
169
169
    corresponds to the "CLIPBOARD" atom; another commonly used clipboard
170
170
    is the "PRIMARY" clipboard, which, in X, traditionally contains
171
171
    the currently selected text.
189
189
    with callbacks to convert it into the various data types that you
190
190
    advertise. When the <em class="parameter"><code>clear_func</code></em> you provided is called, you
191
191
    simply free the data blob. The latter is more useful when the
192
 
    contents of clipboard reflect the internal state of a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
 
192
    contents of clipboard reflect the internal state of a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
193
193
    (As an example, for the PRIMARY clipboard, when an entry widget
194
194
    provides the clipboard's contents the contents are simply the
195
195
    text within the selected region.) If the contents change, the
237
237
<a name="GtkClipboardReceivedFunc"></a><h3>GtkClipboardReceivedFunc ()</h3>
238
238
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardReceivedFunc)         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
239
239
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
240
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
240
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
241
241
<p>
242
242
    A function to be called when the results of <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-contents" title="gtk_clipboard_request_contents ()"><code class="function">gtk_clipboard_request_contents()</code></a>
243
243
    are received, or when the request fails.
269
269
<div class="refsect2" title="GtkClipboardTextReceivedFunc ()">
270
270
<a name="GtkClipboardTextReceivedFunc"></a><h3>GtkClipboardTextReceivedFunc ()</h3>
271
271
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardTextReceivedFunc)     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
272
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
273
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
272
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
 
273
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
274
274
<p>
275
275
    A function to be called when the results of <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-text" title="gtk_clipboard_request_text ()"><code class="function">gtk_clipboard_request_text()</code></a>
276
276
    are received, or when the request fails.
285
285
</tr>
286
286
<tr>
287
287
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
288
 
<td>the text received, as a UTF-8 encoded string, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
288
<td>the text received, as a UTF-8 encoded string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
289
289
            if retrieving the data failed.
290
290
</td>
291
291
</tr>
301
301
<div class="refsect2" title="GtkClipboardImageReceivedFunc ()">
302
302
<a name="GtkClipboardImageReceivedFunc"></a><h3>GtkClipboardImageReceivedFunc ()</h3>
303
303
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardImageReceivedFunc)    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
304
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
305
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
304
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
 
305
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
306
306
<p>
307
307
    A function to be called when the results of <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-image" title="gtk_clipboard_request_image ()"><code class="function">gtk_clipboard_request_image()</code></a>
308
308
    are received, or when the request fails.
333
333
<div class="refsect2" title="GtkClipboardTargetsReceivedFunc ()">
334
334
<a name="GtkClipboardTargetsReceivedFunc"></a><h3>GtkClipboardTargetsReceivedFunc ()</h3>
335
335
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardTargetsReceivedFunc)  (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
336
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
337
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_atoms</code></em>,
338
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
336
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
 
337
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_atoms</code></em>,
 
338
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
339
339
<p>
340
340
    A function to be called when the results of <a class="link" href="gtk-Clipboards.html#gtk-clipboard-request-targets" title="gtk_clipboard_request_targets ()"><code class="function">gtk_clipboard_request_targets()</code></a>
341
341
    are received, or when the request fails.
350
350
</tr>
351
351
<tr>
352
352
<td><p><span class="term"><em class="parameter"><code>atoms</code></em> :</span></p></td>
353
 
<td>the supported targets, as array of <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 
 
353
<td>the supported targets, as array of <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> 
354
354
            if retrieving the data failed.
355
355
</td>
356
356
</tr>
372
372
<div class="refsect2" title="GtkClipboardRichTextReceivedFunc ()">
373
373
<a name="GtkClipboardRichTextReceivedFunc"></a><h3>GtkClipboardRichTextReceivedFunc ()</h3>
374
374
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardRichTextReceivedFunc) (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
375
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
376
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *text</code></em>,
377
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
378
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
375
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
 
376
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *text</code></em>,
 
377
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
 
378
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
379
379
<p>
380
380
</p>
381
381
<div class="variablelist"><table border="0">
413
413
<div class="refsect2" title="GtkClipboardURIReceivedFunc ()">
414
414
<a name="GtkClipboardURIReceivedFunc"></a><h3>GtkClipboardURIReceivedFunc ()</h3>
415
415
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardURIReceivedFunc)      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
416
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uris</code></em>,
417
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
416
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uris</code></em>,
 
417
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
418
418
<p>
419
419
</p>
420
420
<div class="variablelist"><table border="0">
443
443
<a name="GtkClipboardGetFunc"></a><h3>GtkClipboardGetFunc ()</h3>
444
444
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardGetFunc)              (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
445
445
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> *selection_data</code></em>,
446
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>,
447
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);</pre>
 
446
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> info</code></em>,
 
447
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);</pre>
448
448
<p>
449
449
A function that will be called to provide the contents of the selection.
450
450
If multiple types of data were advertised, the requested type can
489
489
<div class="refsect2" title="GtkClipboardClearFunc ()">
490
490
<a name="GtkClipboardClearFunc"></a><h3>GtkClipboardClearFunc ()</h3>
491
491
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkClipboardClearFunc)            (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
492
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);</pre>
 
492
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data_or_owner</code></em>);</pre>
493
493
<p>
494
494
A function that will be called when the contents of the clipboard are changed
495
495
or cleared. Once this has called, the <em class="parameter"><code>user_data_or_owner</code></em> argument
515
515
<hr>
516
516
<div class="refsect2" title="gtk_clipboard_get ()">
517
517
<a name="gtk-clipboard-get"></a><h3>gtk_clipboard_get ()</h3>
518
 
<pre class="programlisting"><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      gtk_clipboard_get                   (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
 
518
<pre class="programlisting"><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      gtk_clipboard_get                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
519
519
<p>
520
520
Returns the clipboard object for the given selection.
521
521
See <a class="link" href="gtk-Clipboards.html#gtk-clipboard-get-for-display" title="gtk_clipboard_get_for_display ()"><code class="function">gtk_clipboard_get_for_display()</code></a> for complete details.
525
525
<tbody>
526
526
<tr>
527
527
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
528
 
<td>a <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard to use
 
528
<td>a <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard to use
529
529
</td>
530
530
</tr>
531
531
<tr>
542
542
<hr>
543
543
<div class="refsect2" title="gtk_clipboard_get_for_display ()">
544
544
<a name="gtk-clipboard-get-for-display"></a><h3>gtk_clipboard_get_for_display ()</h3>
545
 
<pre class="programlisting"><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      gtk_clipboard_get_for_display       (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
546
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
 
545
<pre class="programlisting"><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *      gtk_clipboard_get_for_display       (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
 
546
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
547
547
<p>
548
548
Returns the clipboard object for the given selection.
549
549
Cut/copy/paste menu items and keyboard shortcuts should use
550
 
the default clipboard, returned by passing <a href="/usr/share/gtk-doc/html/gdk/gdk-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS"><code class="literal">GDK_SELECTION_CLIPBOARD</code></a> for <em class="parameter"><code>selection</code></em>.
551
 
(<a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><code class="literal">GDK_NONE</code></a> is supported as a synonym for GDK_SELECTION_CLIPBOARD
 
550
the default clipboard, returned by passing <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS"><code class="literal">GDK_SELECTION_CLIPBOARD</code></a> for <em class="parameter"><code>selection</code></em>.
 
551
(<a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><code class="literal">GDK_NONE</code></a> is supported as a synonym for GDK_SELECTION_CLIPBOARD
552
552
for backwards compatibility reasons.)
553
553
The currently-selected object or text should be provided on the clipboard
554
 
identified by <a href="/usr/share/gtk-doc/html/gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a>. Cut/copy/paste menu items
555
 
conceptually copy the contents of the <a href="/usr/share/gtk-doc/html/gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard
 
554
identified by <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a>. Cut/copy/paste menu items
 
555
conceptually copy the contents of the <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard
556
556
to the default clipboard, i.e. they copy the selection to what the
557
557
user sees as the clipboard.
558
558
</p>
559
559
<p>
560
 
(Passing <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><span class="type">GDK_NONE</span></a> is the same as using <code class="literal">gdk_atom_intern
 
560
(Passing <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><span class="type">GDK_NONE</span></a> is the same as using <code class="literal">gdk_atom_intern
561
561
("CLIPBOARD", FALSE)</code>. See <a class="ulink" href="http://www.freedesktop.org/Standards/clipboards-spec" target="_top">
562
562
http://www.freedesktop.org/Standards/clipboards-spec</a>
563
563
for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY"
564
564
selections under the X window system. On Win32 the
565
 
<a href="/usr/share/gtk-doc/html/gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard is essentially ignored.)
 
565
<a href="http://library.gnome.org/devel/gdk/unstable/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard is essentially ignored.)
566
566
</p>
567
567
<p>
568
568
It's possible to have arbitrary named clipboards; if you do invent
582
582
</tr>
583
583
<tr>
584
584
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
585
 
<td>a <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
 
585
<td>a <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
586
586
            to use.
587
587
</td>
588
588
</tr>
603
603
<hr>
604
604
<div class="refsect2" title="gtk_clipboard_get_display ()">
605
605
<a name="gtk-clipboard-get-display"></a><h3>gtk_clipboard_get_display ()</h3>
606
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="returnvalue">GdkDisplay</span></a> *        gtk_clipboard_get_display           (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
 
606
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="returnvalue">GdkDisplay</span></a> *        gtk_clipboard_get_display           (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
607
607
<p>
608
 
Gets the <a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
 
608
Gets the <a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
609
609
</p>
610
610
<div class="variablelist"><table border="0">
611
611
<col align="left" valign="top">
617
617
</tr>
618
618
<tr>
619
619
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
620
 
<td> the <a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
 
620
<td> the <a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
621
621
 
622
622
</td>
623
623
</tr>
628
628
<hr>
629
629
<div class="refsect2" title="gtk_clipboard_set_with_data ()">
630
630
<a name="gtk-clipboard-set-with-data"></a><h3>gtk_clipboard_set_with_data ()</h3>
631
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_set_with_data         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
631
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_set_with_data         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
632
632
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
633
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
 
633
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
634
634
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
635
635
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
636
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
636
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
637
637
<p>
638
638
Virtually sets the contents of the specified clipboard by providing
639
639
a list of supported formats for the clipboard data and a function
676
676
</tr>
677
677
<tr>
678
678
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
679
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the clipboard data succeeded. If setting
 
679
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the clipboard data succeeded. If setting
680
680
              the clipboard data failed the provided callback functions
681
681
              will be ignored.
682
682
</td>
687
687
<hr>
688
688
<div class="refsect2" title="gtk_clipboard_set_with_owner ()">
689
689
<a name="gtk-clipboard-set-with-owner"></a><h3>gtk_clipboard_set_with_owner ()</h3>
690
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_set_with_owner        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
690
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_set_with_owner        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
691
691
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
692
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
 
692
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_targets</code></em>,
693
693
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardGetFunc" title="GtkClipboardGetFunc ()"><span class="type">GtkClipboardGetFunc</span></a> get_func</code></em>,
694
694
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardClearFunc" title="GtkClipboardClearFunc ()"><span class="type">GtkClipboardClearFunc</span></a> clear_func</code></em>,
695
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *owner</code></em>);</pre>
 
695
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *owner</code></em>);</pre>
696
696
<p>
697
697
Virtually sets the contents of the specified clipboard by providing
698
698
a list of supported formats for the clipboard data and a function
700
700
</p>
701
701
<p>
702
702
The difference between this function and <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-data" title="gtk_clipboard_set_with_data ()"><code class="function">gtk_clipboard_set_with_data()</code></a>
703
 
is that instead of an generic <em class="parameter"><code>user_data</code></em> pointer, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> is passed
 
703
is that instead of an generic <em class="parameter"><code>user_data</code></em> pointer, a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> is passed
704
704
in.
705
705
</p>
706
706
<div class="variablelist"><table border="0">
741
741
</tr>
742
742
<tr>
743
743
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
744
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the clipboard data succeeded. If setting
 
744
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the clipboard data succeeded. If setting
745
745
              the clipboard data failed the provided callback functions
746
746
              will be ignored.
747
747
</td>
752
752
<hr>
753
753
<div class="refsect2" title="gtk_clipboard_get_owner ()">
754
754
<a name="gtk-clipboard-get-owner"></a><h3>gtk_clipboard_get_owner ()</h3>
755
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           gtk_clipboard_get_owner             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
 
755
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           gtk_clipboard_get_owner             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
756
756
<p>
757
757
If the clipboard contents callbacks were set with 
758
758
<a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-owner" title="gtk_clipboard_set_with_owner ()"><code class="function">gtk_clipboard_set_with_owner()</code></a>, and the <a class="link" href="gtk-Clipboards.html#gtk-clipboard-set-with-data" title="gtk_clipboard_set_with_data ()"><code class="function">gtk_clipboard_set_with_data()</code></a> or 
769
769
</tr>
770
770
<tr>
771
771
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
772
 
<td> the owner of the clipboard, if any; otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
772
<td> the owner of the clipboard, if any; otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
773
773
</td>
774
774
</tr>
775
775
</tbody>
799
799
<div class="refsect2" title="gtk_clipboard_set_text ()">
800
800
<a name="gtk-clipboard-set-text"></a><h3>gtk_clipboard_set_text ()</h3>
801
801
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_set_text              (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
802
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
803
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);</pre>
 
802
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>,
 
803
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> len</code></em>);</pre>
804
804
<p>
805
805
Sets the contents of the clipboard to the given UTF-8 string. GTK+ will
806
806
make a copy of the text and take responsibility for responding
833
833
<div class="refsect2" title="gtk_clipboard_set_image ()">
834
834
<a name="gtk-clipboard-set-image"></a><h3>gtk_clipboard_set_image ()</h3>
835
835
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_set_image             (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
836
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
 
836
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
837
837
<p>
838
 
Sets the contents of the clipboard to the given <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. 
 
838
Sets the contents of the clipboard to the given <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. 
839
839
GTK+ will take responsibility for responding for requests 
840
840
for the image, and for converting the image into the 
841
841
requested format.
850
850
</tr>
851
851
<tr>
852
852
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
853
 
<td>a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> 
 
853
<td>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> 
854
854
</td>
855
855
</tr>
856
856
</tbody>
861
861
<div class="refsect2" title="gtk_clipboard_request_contents ()">
862
862
<a name="gtk-clipboard-request-contents"></a><h3>gtk_clipboard_request_contents ()</h3>
863
863
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_contents      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
864
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
 
864
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
865
865
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardReceivedFunc" title="GtkClipboardReceivedFunc ()"><span class="type">GtkClipboardReceivedFunc</span></a> callback</code></em>,
866
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
866
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
867
867
<p>
868
868
Requests the contents of clipboard as the given target.
869
869
When the results of the result are later received the supplied callback
904
904
<a name="gtk-clipboard-request-text"></a><h3>gtk_clipboard_request_text ()</h3>
905
905
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_text          (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
906
906
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardTextReceivedFunc" title="GtkClipboardTextReceivedFunc ()"><span class="type">GtkClipboardTextReceivedFunc</span></a> callback</code></em>,
907
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
907
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
908
908
<p>
909
909
Requests the contents of the clipboard as text. When the text is
910
910
later received, it will be converted to UTF-8 if necessary, and
912
912
</p>
913
913
<p>
914
914
The <em class="parameter"><code>text</code></em> parameter to <em class="parameter"><code>callback</code></em> will contain the resulting text if
915
 
the request succeeded, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This could happen for
 
915
the request succeeded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This could happen for
916
916
various reasons, in particular if the clipboard was empty or if the
917
917
contents of the clipboard could not be converted into text form.
918
918
</p>
944
944
<a name="gtk-clipboard-request-image"></a><h3>gtk_clipboard_request_image ()</h3>
945
945
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_image         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
946
946
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardImageReceivedFunc" title="GtkClipboardImageReceivedFunc ()"><span class="type">GtkClipboardImageReceivedFunc</span></a> callback</code></em>,
947
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
947
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
948
948
<p>
949
949
Requests the contents of the clipboard as image. When the image is
950
 
later received, it will be converted to a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, and
 
950
later received, it will be converted to a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, and
951
951
<em class="parameter"><code>callback</code></em> will be called. 
952
952
</p>
953
953
<p>
954
954
The <em class="parameter"><code>pixbuf</code></em> parameter to <em class="parameter"><code>callback</code></em> will contain the resulting 
955
 
<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> if the request succeeded, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This 
 
955
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> if the request succeeded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This 
956
956
could happen for various reasons, in particular if the clipboard 
957
957
was empty or if the contents of the clipboard could not be 
958
958
converted into an image.
986
986
<a name="gtk-clipboard-request-targets"></a><h3>gtk_clipboard_request_targets ()</h3>
987
987
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_targets       (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
988
988
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardTargetsReceivedFunc" title="GtkClipboardTargetsReceivedFunc ()"><span class="type">GtkClipboardTargetsReceivedFunc</span></a> callback</code></em>,
989
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
989
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
990
990
<p>
991
991
Requests the contents of the clipboard as list of supported targets. 
992
992
When the list is later received, <em class="parameter"><code>callback</code></em> will be called. 
993
993
</p>
994
994
<p>
995
995
The <em class="parameter"><code>targets</code></em> parameter to <em class="parameter"><code>callback</code></em> will contain the resulting targets if
996
 
the request succeeded, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed.
 
996
the request succeeded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed.
997
997
</p>
998
998
<div class="variablelist"><table border="0">
999
999
<col align="left" valign="top">
1025
1025
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_rich_text     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1026
1026
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
1027
1027
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardRichTextReceivedFunc" title="GtkClipboardRichTextReceivedFunc ()"><span class="type">GtkClipboardRichTextReceivedFunc</span></a> callback</code></em>,
1028
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
1028
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1029
1029
<p>
1030
1030
Requests the contents of the clipboard as rich text. When the rich
1031
1031
text is later received, <em class="parameter"><code>callback</code></em> will be called.
1032
1032
</p>
1033
1033
<p>
1034
1034
The <em class="parameter"><code>text</code></em> parameter to <em class="parameter"><code>callback</code></em> will contain the resulting rich
1035
 
text if the request succeeded, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. The <em class="parameter"><code>length</code></em>
 
1035
text if the request succeeded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. The <em class="parameter"><code>length</code></em>
1036
1036
parameter will contain <em class="parameter"><code>text</code></em>'s length. This function can fail for
1037
1037
various reasons, in particular if the clipboard was empty or if the
1038
1038
contents of the clipboard could not be converted into rich text form.
1071
1071
<a name="gtk-clipboard-request-uris"></a><h3>gtk_clipboard_request_uris ()</h3>
1072
1072
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_request_uris          (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1073
1073
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardURIReceivedFunc" title="GtkClipboardURIReceivedFunc ()"><span class="type">GtkClipboardURIReceivedFunc</span></a> callback</code></em>,
1074
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
1074
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1075
1075
<p>
1076
1076
Requests the contents of the clipboard as URIs. When the URIs are
1077
1077
later received <em class="parameter"><code>callback</code></em> will be called.
1078
1078
</p>
1079
1079
<p>
1080
1080
The <em class="parameter"><code>uris</code></em> parameter to <em class="parameter"><code>callback</code></em> will contain the resulting array of
1081
 
URIs if the request succeeded, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This could happen
 
1081
URIs if the request succeeded, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it failed. This could happen
1082
1082
for various reasons, in particular if the clipboard was empty or if the
1083
1083
contents of the clipboard could not be converted into URI form.
1084
1084
</p>
1110
1110
<div class="refsect2" title="gtk_clipboard_wait_for_contents ()">
1111
1111
<a name="gtk-clipboard-wait-for-contents"></a><h3>gtk_clipboard_wait_for_contents ()</h3>
1112
1112
<pre class="programlisting"><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="returnvalue">GtkSelectionData</span></a> *  gtk_clipboard_wait_for_contents     (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1113
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
 
1113
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
1114
1114
<p>
1115
1115
Requests the contents of the clipboard using the given target.
1116
1116
This function waits for the data to be received using the main 
1132
1132
</tr>
1133
1133
<tr>
1134
1134
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1135
 
<td> a newly-allocated <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1136
 
              if retrieving the given target failed. If non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
 
1135
<td> a newly-allocated <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1136
              if retrieving the given target failed. If non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
1137
1137
              this value must be freed with <a class="link" href="gtk-Selections.html#gtk-selection-data-free" title="gtk_selection_data_free ()"><code class="function">gtk_selection_data_free()</code></a> 
1138
1138
              when you are finished with it.
1139
1139
</td>
1144
1144
<hr>
1145
1145
<div class="refsect2" title="gtk_clipboard_wait_for_text ()">
1146
1146
<a name="gtk-clipboard-wait-for-text"></a><h3>gtk_clipboard_wait_for_text ()</h3>
1147
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_clipboard_wait_for_text         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
 
1147
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_clipboard_wait_for_text         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1148
1148
<p>
1149
1149
Requests the contents of the clipboard as text and converts
1150
1150
the result to UTF-8 if necessary. This function waits for
1162
1162
<tr>
1163
1163
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1164
1164
<td> a newly-allocated UTF-8 string which must
1165
 
              be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if retrieving
 
1165
              be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if retrieving
1166
1166
              the selection data failed. (This could happen
1167
1167
              for various reasons, in particular if the
1168
1168
              clipboard was empty or if the contents of the
1175
1175
<hr>
1176
1176
<div class="refsect2" title="gtk_clipboard_wait_for_image ()">
1177
1177
<a name="gtk-clipboard-wait-for-image"></a><h3>gtk_clipboard_wait_for_image ()</h3>
1178
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_clipboard_wait_for_image        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
 
1178
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_clipboard_wait_for_image        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1179
1179
<p>
1180
1180
Requests the contents of the clipboard as image and converts
1181
 
the result to a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. This function waits for
 
1181
the result to a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. This function waits for
1182
1182
the data to be received using the main loop, so events,
1183
1183
timeouts, etc, may be dispatched during the wait.
1184
1184
</p>
1192
1192
</tr>
1193
1193
<tr>
1194
1194
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1195
 
<td> a newly-allocated <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> object which must
1196
 
              be disposed with <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
1195
<td> a newly-allocated <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> object which must
 
1196
              be disposed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
1197
1197
              retrieving the selection data failed. (This 
1198
1198
              could happen for various reasons, in particular 
1199
1199
              if the clipboard was empty or if the contents of 
1208
1208
<hr>
1209
1209
<div class="refsect2" title="gtk_clipboard_wait_for_rich_text ()">
1210
1210
<a name="gtk-clipboard-wait-for-rich-text"></a><h3>gtk_clipboard_wait_for_rich_text ()</h3>
1211
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *            gtk_clipboard_wait_for_rich_text    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
1211
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *            gtk_clipboard_wait_for_rich_text    (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1212
1212
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
1213
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
1214
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
 
1213
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
 
1214
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
1215
1215
<p>
1216
1216
Requests the contents of the clipboard as rich text.  This function
1217
1217
waits for the data to be received using the main loop, so events,
1243
1243
<tr>
1244
1244
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1245
1245
<td> a newly-allocated binary block of data which must
1246
 
              be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if retrieving
 
1246
              be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if retrieving
1247
1247
              the selection data failed. (This could happen
1248
1248
              for various reasons, in particular if the
1249
1249
              clipboard was empty or if the contents of the
1258
1258
<hr>
1259
1259
<div class="refsect2" title="gtk_clipboard_wait_for_uris ()">
1260
1260
<a name="gtk-clipboard-wait-for-uris"></a><h3>gtk_clipboard_wait_for_uris ()</h3>
1261
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            gtk_clipboard_wait_for_uris         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
 
1261
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            gtk_clipboard_wait_for_uris         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1262
1262
<p>
1263
1263
Requests the contents of the clipboard as URIs. This function waits
1264
1264
for the data to be received using the main loop, so events,
1275
1275
<tr>
1276
1276
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1277
1277
<td> a newly-allocated
1278
 
                 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings which must
1279
 
              be freed with <a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
1278
                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings which must
 
1279
              be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
1280
1280
              retrieving the selection data failed. (This
1281
1281
              could happen for various reasons, in particular
1282
1282
              if the clipboard was empty or if the contents of
1290
1290
<hr>
1291
1291
<div class="refsect2" title="gtk_clipboard_wait_is_text_available ()">
1292
1292
<a name="gtk-clipboard-wait-is-text-available"></a><h3>gtk_clipboard_wait_is_text_available ()</h3>
1293
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_text_available
 
1293
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_text_available
1294
1294
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1295
1295
<p>
1296
1296
Test to see if there is text available to be pasted
1314
1314
</tr>
1315
1315
<tr>
1316
1316
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1317
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is text available, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 
1317
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is text available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1318
1318
</td>
1319
1319
</tr>
1320
1320
</tbody>
1323
1323
<hr>
1324
1324
<div class="refsect2" title="gtk_clipboard_wait_is_image_available ()">
1325
1325
<a name="gtk-clipboard-wait-is-image-available"></a><h3>gtk_clipboard_wait_is_image_available ()</h3>
1326
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_image_available
 
1326
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_image_available
1327
1327
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1328
1328
<p>
1329
1329
Test to see if there is an image available to be pasted
1347
1347
</tr>
1348
1348
<tr>
1349
1349
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1350
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is an image available, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 
1350
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is an image available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1351
1351
 
1352
1352
</td>
1353
1353
</tr>
1358
1358
<hr>
1359
1359
<div class="refsect2" title="gtk_clipboard_wait_is_rich_text_available ()">
1360
1360
<a name="gtk-clipboard-wait-is-rich-text-available"></a><h3>gtk_clipboard_wait_is_rich_text_available ()</h3>
1361
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_rich_text_available
 
1361
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_rich_text_available
1362
1362
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1363
1363
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
1364
1364
<p>
1388
1388
</tr>
1389
1389
<tr>
1390
1390
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1391
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is rich text available, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 
1391
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is rich text available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1392
1392
 
1393
1393
</td>
1394
1394
</tr>
1399
1399
<hr>
1400
1400
<div class="refsect2" title="gtk_clipboard_wait_is_uris_available ()">
1401
1401
<a name="gtk-clipboard-wait-is-uris-available"></a><h3>gtk_clipboard_wait_is_uris_available ()</h3>
1402
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_uris_available
 
1402
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_uris_available
1403
1403
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
1404
1404
<p>
1405
1405
Test to see if there is a list of URIs available to be pasted
1423
1423
</tr>
1424
1424
<tr>
1425
1425
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1426
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is an URI list available, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 
1426
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is there is an URI list available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1427
1427
 
1428
1428
</td>
1429
1429
</tr>
1434
1434
<hr>
1435
1435
<div class="refsect2" title="gtk_clipboard_wait_for_targets ()">
1436
1436
<a name="gtk-clipboard-wait-for-targets"></a><h3>gtk_clipboard_wait_for_targets ()</h3>
1437
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_for_targets      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1438
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
1439
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_targets</code></em>);</pre>
 
1437
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_for_targets      (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
 
1438
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
 
1439
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_targets</code></em>);</pre>
1440
1440
<p>
1441
 
Returns a list of targets that are present on the clipboard, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1441
Returns a list of targets that are present on the clipboard, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1442
1442
if there aren't any targets available. The returned list must be 
1443
 
freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
 
1443
freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
1444
1444
This function waits for the data to be received using the main 
1445
1445
loop, so events, timeouts, etc, may be dispatched during the wait.
1446
1446
</p>
1455
1455
<tr>
1456
1456
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
1457
1457
<td>location to store an array of targets. The result
1458
 
          stored here must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
 
1458
          stored here must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
1459
1459
</td>
1460
1460
</tr>
1461
1461
<tr>
1465
1465
</tr>
1466
1466
<tr>
1467
1467
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1468
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if any targets are present on the clipboard,
1469
 
              otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
 
1468
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if any targets are present on the clipboard,
 
1469
              otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
1470
1470
 
1471
1471
</td>
1472
1472
</tr>
1477
1477
<hr>
1478
1478
<div class="refsect2" title="gtk_clipboard_wait_is_target_available ()">
1479
1479
<a name="gtk-clipboard-wait-is-target-available"></a><h3>gtk_clipboard_wait_is_target_available ()</h3>
1480
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_target_available
 
1480
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_clipboard_wait_is_target_available
1481
1481
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1482
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
 
1482
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
1483
1483
<p>
1484
1484
Checks if a clipboard supports pasting data of a given type. This
1485
1485
function can be used to determine if a "Paste" menu item should be
1499
1499
</tr>
1500
1500
<tr>
1501
1501
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1502
 
<td>A <a href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> indicating which target to look for.
 
1502
<td>A <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> indicating which target to look for.
1503
1503
</td>
1504
1504
</tr>
1505
1505
<tr>
1506
1506
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1507
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target is available, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 
1507
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the target is available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1508
1508
 
1509
1509
</td>
1510
1510
</tr>
1517
1517
<a name="gtk-clipboard-set-can-store"></a><h3>gtk_clipboard_set_can_store ()</h3>
1518
1518
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_clipboard_set_can_store         (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1519
1519
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
1520
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);</pre>
 
1520
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>);</pre>
1521
1521
<p>
1522
1522
Hints that the clipboard data should be stored somewhere when the
1523
1523
application exits or when <a class="link" href="gtk-Clipboards.html#gtk-clipboard-store" title="gtk_clipboard_store ()"><code class="function">gtk_clipboard_store()</code></a> is called.
1525
1525
<p>
1526
1526
This value is reset when the clipboard owner changes.
1527
1527
Where the clipboard data is stored is platform dependent,
1528
 
see <a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html#gdk-display-store-clipboard"><code class="function">gdk_display_store_clipboard()</code></a> for more information.
 
1528
see <a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html#gdk-display-store-clipboard"><code class="function">gdk_display_store_clipboard()</code></a> for more information.
1529
1529
</p>
1530
1530
<div class="variablelist"><table border="0">
1531
1531
<col align="left" valign="top">
1537
1537
</tr>
1538
1538
<tr>
1539
1539
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
1540
 
<td>array containing information about which forms should be stored
1541
 
          or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that all forms should be stored.
 
1540
<td> array containing information about which forms 
 
1541
          should be stored or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate that all forms should 
 
1542
          be stored. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1542
1543
</td>
1543
1544
</tr>
1544
1545
<tr>
1574
1575
<div class="refsect2" title='The "owner-change" signal'>
1575
1576
<a name="GtkClipboard-owner-change"></a><h3>The <code class="literal">"owner-change"</code> signal</h3>
1576
1577
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard,
1577
 
                                                        <a href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>     *event,
1578
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : Run First</pre>
 
1578
                                                        <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>     *event,
 
1579
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : Run First</pre>
1579
1580
<p>
1580
1581
The ::owner-change signal is emitted when GTK+ receives an
1581
1582
event that indicates that the ownership of the selection