← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Sebastien Bacher
  • Date: 2012-02-06 22:03:26 UTC
  • mfrom: (1.14.12)
  • Revision ID: package-import@ubuntu.com-20120206220326-10d7cnkpdpbi9iox
Tags: 2.24.10-0ubuntu1
https://launchpad.net/bugs/920961
* New upstream version, dropped patches included in the new version
* debian/patches/090_logging_file_saves.patch:
  - improve the logging of saved filed, thanks Siegfried Gevatter 
    (lp: #920961)

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/gtk-Clipboards.html
8
8
<link rel="up" href="gtkbase.html" title="Part II. GTK+ Core Reference">
9
9
<link rel="prev" href="gtk-Accelerator-Maps.html" title="Accelerator Maps">
10
10
<link rel="next" href="gtk-Drag-and-Drop.html" title="Drag and Drop">
11
 
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
55
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
56
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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
 
58
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
59
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
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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
 
62
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
63
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
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
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>);
72
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
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/gdk3/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/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
77
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
78
 
<a href="http://library.gnome.org/devel/gdk3/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>);
 
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="../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="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
 
77
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
 
78
<a href="../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
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
80
                                                         <em class="parameter"><code>const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
81
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>,
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
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
 
99
                                                         <em class="parameter"><code><a href="../gdk/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
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>,
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
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"><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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
 
119
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
120
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
121
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.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
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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
 
124
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
125
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
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
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>
134
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
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/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
 
137
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
138
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
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="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);
 
141
                                                         <em class="parameter"><code><a href="../gdk/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="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
144
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>);
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="http://library.gnome.org/devel/gdk3/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/gdk3/gdk-Properties-and-Atoms.html#gdk-atom-intern"><code class="function">gdk_atom_intern()</code></a> and <a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#gdk-atom-name"><code class="function">gdk_atom_name()</code></a>.) The default clipboard
 
167
    <a href="../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="../gdk/gdk-Properties-and-Atoms.html#gdk-atom-intern"><code class="function">gdk_atom_intern()</code></a> and <a href="../gdk/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.
327
327
<div class="refsect2">
328
328
<a name="GtkClipboardTargetsReceivedFunc"></a><h3>GtkClipboardTargetsReceivedFunc ()</h3>
329
329
<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>,
330
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
 
330
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *atoms</code></em>,
331
331
                                                         <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>,
332
332
                                                         <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>
333
333
<p>
344
344
</tr>
345
345
<tr>
346
346
<td><p><span class="term"><em class="parameter"><code>atoms</code></em> :</span></p></td>
347
 
<td>the supported targets, as array of <a href="http://library.gnome.org/devel/gdk3/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>
 
347
<td>the supported targets, as array of <a href="../gdk/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>
348
348
if retrieving the data failed.</td>
349
349
</tr>
350
350
<tr>
363
363
<div class="refsect2">
364
364
<a name="GtkClipboardRichTextReceivedFunc"></a><h3>GtkClipboardRichTextReceivedFunc ()</h3>
365
365
<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>,
366
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
 
366
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> format</code></em>,
367
367
                                                         <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>,
368
368
                                                         <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>,
369
369
                                                         <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>
454
454
<hr>
455
455
<div class="refsect2">
456
456
<a name="gtk-clipboard-get"></a><h3>gtk_clipboard_get ()</h3>
457
 
<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/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
 
457
<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="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
458
458
<p>
459
459
Returns the clipboard object for the given selection.
460
460
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.
464
464
<tbody>
465
465
<tr>
466
466
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
467
 
<td>a <a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard to use</td>
 
467
<td>a <a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard to use</td>
468
468
</tr>
469
469
<tr>
470
470
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
480
480
<hr>
481
481
<div class="refsect2">
482
482
<a name="gtk-clipboard-get-for-display"></a><h3>gtk_clipboard_get_for_display ()</h3>
483
 
<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/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
484
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
 
483
<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="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>,
 
484
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
485
485
<p>
486
486
Returns the clipboard object for the given selection.
487
487
Cut/copy/paste menu items and keyboard shortcuts should use
488
 
the default clipboard, returned by passing <a href="http://library.gnome.org/devel/gdk3/gdk-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS"><code class="literal">GDK_SELECTION_CLIPBOARD</code></a> for <em class="parameter"><code>selection</code></em>.
489
 
(<a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"><code class="literal">GDK_NONE</code></a> is supported as a synonym for GDK_SELECTION_CLIPBOARD
 
488
the default clipboard, returned by passing <a href="../gdk/gdk-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS"><code class="literal">GDK_SELECTION_CLIPBOARD</code></a> for <em class="parameter"><code>selection</code></em>.
 
489
(<a href="../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
490
490
for backwards compatibility reasons.)
491
491
The currently-selected object or text should be provided on the clipboard
492
 
identified by <a href="http://library.gnome.org/devel/gdk3/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a>. Cut/copy/paste menu items
493
 
conceptually copy the contents of the <a href="http://library.gnome.org/devel/gdk3/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard
 
492
identified by <a href="../gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a>. Cut/copy/paste menu items
 
493
conceptually copy the contents of the <a href="../gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard
494
494
to the default clipboard, i.e. they copy the selection to what the
495
495
user sees as the clipboard.
496
496
</p>
497
497
<p>
498
 
(Passing <a href="http://library.gnome.org/devel/gdk3/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
 
498
(Passing <a href="../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
499
499
("CLIPBOARD", FALSE)</code>. See <a class="ulink" href="http://www.freedesktop.org/Standards/clipboards-spec" target="_top">
500
500
http://www.freedesktop.org/Standards/clipboards-spec</a>
501
501
for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY"
502
502
selections under the X window system. On Win32 the
503
 
<a href="http://library.gnome.org/devel/gdk3/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard is essentially ignored.)
 
503
<a href="../gdk/gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><span class="type">GDK_SELECTION_PRIMARY</span></a> clipboard is essentially ignored.)
504
504
</p>
505
505
<p>
506
506
It's possible to have arbitrary named clipboards; if you do invent
519
519
</tr>
520
520
<tr>
521
521
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
522
 
<td>a <a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
 
522
<td>a <a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
523
523
to use.</td>
524
524
</tr>
525
525
<tr>
539
539
<hr>
540
540
<div class="refsect2">
541
541
<a name="gtk-clipboard-get-display"></a><h3>gtk_clipboard_get_display ()</h3>
542
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/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>
 
542
<pre class="programlisting"><a href="../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>
543
543
<p>
544
 
Gets the <a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
 
544
Gets the <a href="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>
545
545
</p>
546
546
<div class="variablelist"><table border="0">
547
547
<col align="left" valign="top">
553
553
</tr>
554
554
<tr>
555
555
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
556
 
<td>the <a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
556
<td>the <a href="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> associated with <em class="parameter"><code>clipboard</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
557
557
</td>
558
558
</tr>
559
559
</tbody>
784
784
<div class="refsect2">
785
785
<a name="gtk-clipboard-request-contents"></a><h3>gtk_clipboard_request_contents ()</h3>
786
786
<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>,
787
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
 
787
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
788
788
                                                         <em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboardReceivedFunc" title="GtkClipboardReceivedFunc ()"><span class="type">GtkClipboardReceivedFunc</span></a> callback</code></em>,
789
789
                                                         <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>
790
790
<p>
1021
1021
<div class="refsect2">
1022
1022
<a name="gtk-clipboard-wait-for-contents"></a><h3>gtk_clipboard_wait_for_contents ()</h3>
1023
1023
<pre class="programlisting"><a class="link" href="GtkWidget.html#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>,
1024
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
 
1024
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
1025
1025
<p>
1026
1026
Requests the contents of the clipboard using the given target.
1027
1027
This function waits for the data to be received using the main 
1117
1117
<a name="gtk-clipboard-wait-for-rich-text"></a><h3>gtk_clipboard_wait_for_rich_text ()</h3>
1118
1118
<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>,
1119
1119
                                                         <em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
1120
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
 
1120
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> *format</code></em>,
1121
1121
                                                         <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>
1122
1122
<p>
1123
1123
Requests the contents of the clipboard as rich text.  This function
1337
1337
<div class="refsect2">
1338
1338
<a name="gtk-clipboard-wait-for-targets"></a><h3>gtk_clipboard_wait_for_targets ()</h3>
1339
1339
<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>,
1340
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
 
1340
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> **targets</code></em>,
1341
1341
                                                         <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>
1342
1342
<p>
1343
1343
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>
1379
1379
<a name="gtk-clipboard-wait-is-target-available"></a><h3>gtk_clipboard_wait_is_target_available ()</h3>
1380
1380
<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
1381
1381
                                                        (<em class="parameter"><code><a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
1382
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
 
1382
                                                         <em class="parameter"><code><a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>);</pre>
1383
1383
<p>
1384
1384
Checks if a clipboard supports pasting data of a given type. This
1385
1385
function can be used to determine if a "Paste" menu item should be
1399
1399
</tr>
1400
1400
<tr>
1401
1401
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
1402
 
<td>A <a href="http://library.gnome.org/devel/gdk3/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> indicating which target to look for.</td>
 
1402
<td>A <a href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> indicating which target to look for.</td>
1403
1403
</tr>
1404
1404
<tr>
1405
1405
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1423
1423
<p>
1424
1424
This value is reset when the clipboard owner changes.
1425
1425
Where the clipboard data is stored is platform dependent,
1426
 
see <a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html#gdk-display-store-clipboard"><code class="function">gdk_display_store_clipboard()</code></a> for more information.
 
1426
see <a href="../gdk/GdkDisplay.html#gdk-display-store-clipboard"><code class="function">gdk_display_store_clipboard()</code></a> for more information.
1427
1427
</p>
1428
1428
<div class="variablelist"><table border="0">
1429
1429
<col align="left" valign="top">
1473
1473
<div class="refsect2">
1474
1474
<a name="GtkClipboard-owner-change"></a><h3>The <code class="literal">"owner-change"</code> signal</h3>
1475
1475
<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,
1476
 
                                                        <a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>     *event,
 
1476
                                                        <a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>     *event,
1477
1477
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
1478
1478
<p>
1479
1479
The ::owner-change signal is emitted when GTK+ receives an
1520
1520
</div>
1521
1521
<div class="footer">
1522
1522
<hr>
1523
 
          Generated by GTK-Doc V1.17</div>
 
1523
          Generated by GTK-Doc V1.18</div>
1524
1524
</body>
1525
1525
</html>
 
 
b'\\ No newline at end of file'