← Back to branch summary

~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Selections.html

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2013-01-10 12:53:20 UTC
  • mfrom: (1.14.16)
  • Revision ID: package-import@ubuntu.com-20130110125320-x13bjpwtqq36izs2
Tags: 2.24.14-0ubuntu1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/html/gdk-Selections.html
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>Selections</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
 
<link rel="home" href="index.html" title="GDK 2 Reference Manual">
8
 
<link rel="up" href="reference.html" title="API Reference">
9
 
<link rel="prev" href="gdk-Keyboard-Handling.html" title="Key Values">
10
 
<link rel="next" href="gdk-Drag-and-Drop.html" title="Drag and Drop">
11
 
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
</head>
14
 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="gdk-Keyboard-Handling.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">GDK 2 Reference Manual</th>
21
 
<td><a accesskey="n" href="gdk-Drag-and-Drop.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#gdk-Selections.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#gdk-Selections.description" class="shortcut">Description</a>
27
 
</td></tr>
28
 
</table>
29
 
<div class="refentry">
30
 
<a name="gdk-Selections"></a><div class="titlepage"></div>
31
 
<div class="refnamediv"><table width="100%"><tr>
32
 
<td valign="top">
33
 
<h2><span class="refentrytitle"><a name="gdk-Selections.top_of_page"></a>Selections</span></h2>
34
 
<p>Selections — Functions for transfering data via the X selection mechanism</p>
35
 
</td>
36
 
<td valign="top" align="right"></td>
37
 
</tr></table></div>
38
 
<div class="refsynopsisdiv">
39
 
<a name="gdk-Selections.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis">
41
 
#include &lt;gdk/gdk.h&gt;
42
 
 
43
 
typedef             <a class="link" href="gdk-Selections.html#GdkSelection" title="GdkSelection">GdkSelection</a>;
44
 
typedef             <a class="link" href="gdk-Selections.html#GdkSelectionType" title="GdkSelectionType">GdkSelectionType</a>;
45
 
typedef             <a class="link" href="gdk-Selections.html#GdkTarget" title="GdkTarget">GdkTarget</a>;
46
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-PRIMARY:CAPS" title="GDK_SELECTION_PRIMARY">GDK_SELECTION_PRIMARY</a>
47
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-SECONDARY:CAPS" title="GDK_SELECTION_SECONDARY">GDK_SELECTION_SECONDARY</a>
48
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS" title="GDK_SELECTION_CLIPBOARD">GDK_SELECTION_CLIPBOARD</a>
49
 
#define             <a class="link" href="gdk-Selections.html#GDK-TARGET-BITMAP:CAPS" title="GDK_TARGET_BITMAP">GDK_TARGET_BITMAP</a>
50
 
#define             <a class="link" href="gdk-Selections.html#GDK-TARGET-COLORMAP:CAPS" title="GDK_TARGET_COLORMAP">GDK_TARGET_COLORMAP</a>
51
 
#define             <a class="link" href="gdk-Selections.html#GDK-TARGET-DRAWABLE:CAPS" title="GDK_TARGET_DRAWABLE">GDK_TARGET_DRAWABLE</a>
52
 
#define             <a class="link" href="gdk-Selections.html#GDK-TARGET-PIXMAP:CAPS" title="GDK_TARGET_PIXMAP">GDK_TARGET_PIXMAP</a>
53
 
#define             <a class="link" href="gdk-Selections.html#GDK-TARGET-STRING:CAPS" title="GDK_TARGET_STRING">GDK_TARGET_STRING</a>
54
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-ATOM:CAPS" title="GDK_SELECTION_TYPE_ATOM">GDK_SELECTION_TYPE_ATOM</a>
55
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-BITMAP:CAPS" title="GDK_SELECTION_TYPE_BITMAP">GDK_SELECTION_TYPE_BITMAP</a>
56
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-COLORMAP:CAPS" title="GDK_SELECTION_TYPE_COLORMAP">GDK_SELECTION_TYPE_COLORMAP</a>
57
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-DRAWABLE:CAPS" title="GDK_SELECTION_TYPE_DRAWABLE">GDK_SELECTION_TYPE_DRAWABLE</a>
58
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-INTEGER:CAPS" title="GDK_SELECTION_TYPE_INTEGER">GDK_SELECTION_TYPE_INTEGER</a>
59
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-PIXMAP:CAPS" title="GDK_SELECTION_TYPE_PIXMAP">GDK_SELECTION_TYPE_PIXMAP</a>
60
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-WINDOW:CAPS" title="GDK_SELECTION_TYPE_WINDOW">GDK_SELECTION_TYPE_WINDOW</a>
61
 
#define             <a class="link" href="gdk-Selections.html#GDK-SELECTION-TYPE-STRING:CAPS" title="GDK_SELECTION_TYPE_STRING">GDK_SELECTION_TYPE_STRING</a>
62
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Selections.html#gdk-selection-owner-set" title="gdk_selection_owner_set ()">gdk_selection_owner_set</a>             (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
63
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
64
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
65
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);
66
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Selections.html#gdk-selection-owner-set-for-display" title="gdk_selection_owner_set_for_display ()">gdk_selection_owner_set_for_display</a> (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
67
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
68
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
69
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
70
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);
71
 
<a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk-Selections.html#gdk-selection-owner-get" title="gdk_selection_owner_get ()">gdk_selection_owner_get</a>             (<em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
72
 
<a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk-Selections.html#gdk-selection-owner-get-for-display" title="gdk_selection_owner_get_for_display ()">gdk_selection_owner_get_for_display</a> (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
73
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);
74
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-Selections.html#gdk-selection-convert" title="gdk_selection_convert ()">gdk_selection_convert</a>               (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
75
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
76
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
77
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
78
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Selections.html#gdk-selection-property-get" title="gdk_selection_property_get ()">gdk_selection_property_get</a>          (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
79
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **data</code></em>,
80
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *prop_type</code></em>,
81
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *prop_format</code></em>);
82
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-Selections.html#gdk-selection-send-notify" title="gdk_selection_send_notify ()">gdk_selection_send_notify</a>           (<em class="parameter"><code><a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> requestor</code></em>,
83
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
84
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
85
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
86
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
87
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-Selections.html#gdk-selection-send-notify-for-display" title="gdk_selection_send_notify_for_display ()">gdk_selection_send_notify_for_display</a>
88
 
                                                        (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
89
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> requestor</code></em>,
90
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
91
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
92
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
93
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
94
 
</pre>
95
 
</div>
96
 
<div class="refsect1">
97
 
<a name="gdk-Selections.description"></a><h2>Description</h2>
98
 
<p>
99
 
The X selection mechanism provides a way to transfer
100
 
arbitrary chunks of data between programs.
101
 
A <em class="firstterm">selection</em> is a essentially
102
 
a named clipboard, identified by a string interned
103
 
as a <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>. By claiming ownership of a selection,
104
 
an application indicates that it will be responsible
105
 
for supplying its contents. The most common
106
 
selections are <code class="literal">PRIMARY</code> and
107
 
<code class="literal">CLIPBOARD</code>.
108
 
</p>
109
 
<p>
110
 
The contents of a selection can be represented in
111
 
a number of formats, called <em class="firstterm">targets</em>.
112
 
Each target is identified by an atom. A list of
113
 
all possible targets supported by the selection owner
114
 
can be retrieved by requesting the special target
115
 
<code class="literal">TARGETS</code>. When a selection is
116
 
retrieved, the data is accompanied by a type
117
 
(an atom), and a format (an integer, representing
118
 
the number of bits per item).
119
 
See <a class="link" href="gdk-Properties-and-Atoms.html" title="Properties and Atoms">Properties and Atoms</a>
120
 
for more information.
121
 
</p>
122
 
<p>
123
 
The functions in this section only contain the lowlevel
124
 
parts of the selection protocol. A considerably more
125
 
complicated implementation is needed on top of this.
126
 
GTK+ contains such an implementation in the functions
127
 
in <code class="literal">gtkselection.h</code> and programmers
128
 
should use those functions instead of the ones presented
129
 
here. If you plan to implement selection handling
130
 
directly on top of the functions here, you should refer
131
 
to the X Inter-client Communication Conventions Manual
132
 
(ICCCM).
133
 
</p>
134
 
</div>
135
 
<div class="refsect1">
136
 
<a name="gdk-Selections.details"></a><h2>Details</h2>
137
 
<div class="refsect2">
138
 
<a name="GdkSelection"></a><h3>GdkSelection</h3>
139
 
<pre class="programlisting">typedef GdkAtom GdkSelection;
140
 
</pre>
141
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
142
 
<h3 class="title">Warning</h3>
143
 
<p><code class="literal">GdkSelection</code> is deprecated and should not be used in newly-written code.</p>
144
 
</div>
145
 
<p>
146
 
The <a class="link" href="gdk-Selections.html#GdkSelection" title="GdkSelection"><span class="type">GdkSelection</span></a> enumeration contains predefined
147
 
atom values for several common selections.
148
 
</p>
149
 
</div>
150
 
<hr>
151
 
<div class="refsect2">
152
 
<a name="GdkSelectionType"></a><h3>GdkSelectionType</h3>
153
 
<pre class="programlisting">typedef GdkAtom GdkSelectionType;
154
 
</pre>
155
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
156
 
<h3 class="title">Warning</h3>
157
 
<p><code class="literal">GdkSelectionType</code> is deprecated and should not be used in newly-written code.</p>
158
 
</div>
159
 
<p>
160
 
The <a class="link" href="gdk-Selections.html#GdkSelectionType" title="GdkSelectionType"><span class="type">GdkSelectionType</span></a> enumeration contains predefined
161
 
atom values used to represent the types of data transferred
162
 
in response to a request for a target. See the
163
 
ICCCM for details about what data should be transferred
164
 
for each of these types. Other atoms can be used,
165
 
and the recommended practice for GTK+ is to to use mime
166
 
types for this purpose. However, supporting these types
167
 
may be useful for compatibility with older programs.
168
 
</p>
169
 
</div>
170
 
<hr>
171
 
<div class="refsect2">
172
 
<a name="GdkTarget"></a><h3>GdkTarget</h3>
173
 
<pre class="programlisting">typedef GdkAtom GdkTarget;
174
 
</pre>
175
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
176
 
<h3 class="title">Warning</h3>
177
 
<p><code class="literal">GdkTarget</code> is deprecated and should not be used in newly-written code.</p>
178
 
</div>
179
 
<p>
180
 
The <a class="link" href="gdk-Selections.html#GdkTarget" title="GdkTarget"><span class="type">GdkTarget</span></a> enumeration contains predefined atom values which are
181
 
used to describe possible targets for a selection. Other atoms can be
182
 
used, and the recommended practice for GTK+ is to to use mime types
183
 
for this purpose. However, supporting these types may be useful for
184
 
compatibility with older programs.
185
 
</p>
186
 
</div>
187
 
<hr>
188
 
<div class="refsect2">
189
 
<a name="GDK-SELECTION-PRIMARY:CAPS"></a><h3>GDK_SELECTION_PRIMARY</h3>
190
 
<pre class="programlisting">#define GDK_SELECTION_PRIMARY               _GDK_MAKE_ATOM (1)
191
 
</pre>
192
 
<p>
193
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">PRIMARY</code> selection.
194
 
</p>
195
 
</div>
196
 
<hr>
197
 
<div class="refsect2">
198
 
<a name="GDK-SELECTION-SECONDARY:CAPS"></a><h3>GDK_SELECTION_SECONDARY</h3>
199
 
<pre class="programlisting">#define GDK_SELECTION_SECONDARY     _GDK_MAKE_ATOM (2)
200
 
</pre>
201
 
<p>
202
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">SECONDARY</code> selection.
203
 
</p>
204
 
</div>
205
 
<hr>
206
 
<div class="refsect2">
207
 
<a name="GDK-SELECTION-CLIPBOARD:CAPS"></a><h3>GDK_SELECTION_CLIPBOARD</h3>
208
 
<pre class="programlisting">#define GDK_SELECTION_CLIPBOARD     _GDK_MAKE_ATOM (69)
209
 
</pre>
210
 
<p>
211
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">CLIPBOARD</code> selection.
212
 
</p>
213
 
</div>
214
 
<hr>
215
 
<div class="refsect2">
216
 
<a name="GDK-TARGET-BITMAP:CAPS"></a><h3>GDK_TARGET_BITMAP</h3>
217
 
<pre class="programlisting">#define GDK_TARGET_BITMAP           _GDK_MAKE_ATOM (5)
218
 
</pre>
219
 
<p>
220
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">BITMAP</code> selection target.
221
 
</p>
222
 
</div>
223
 
<hr>
224
 
<div class="refsect2">
225
 
<a name="GDK-TARGET-COLORMAP:CAPS"></a><h3>GDK_TARGET_COLORMAP</h3>
226
 
<pre class="programlisting">#define GDK_TARGET_COLORMAP                 _GDK_MAKE_ATOM (7)
227
 
</pre>
228
 
<p>
229
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">COLORMAP</code> selection target.
230
 
</p>
231
 
</div>
232
 
<hr>
233
 
<div class="refsect2">
234
 
<a name="GDK-TARGET-DRAWABLE:CAPS"></a><h3>GDK_TARGET_DRAWABLE</h3>
235
 
<pre class="programlisting">#define GDK_TARGET_DRAWABLE                 _GDK_MAKE_ATOM (17)
236
 
</pre>
237
 
<p>
238
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">DRAWABLE</code> selection target.
239
 
</p>
240
 
</div>
241
 
<hr>
242
 
<div class="refsect2">
243
 
<a name="GDK-TARGET-PIXMAP:CAPS"></a><h3>GDK_TARGET_PIXMAP</h3>
244
 
<pre class="programlisting">#define GDK_TARGET_PIXMAP           _GDK_MAKE_ATOM (20)
245
 
</pre>
246
 
<p>
247
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">PIXMAP</code> selection target.
248
 
</p>
249
 
</div>
250
 
<hr>
251
 
<div class="refsect2">
252
 
<a name="GDK-TARGET-STRING:CAPS"></a><h3>GDK_TARGET_STRING</h3>
253
 
<pre class="programlisting">#define GDK_TARGET_STRING           _GDK_MAKE_ATOM (31)
254
 
</pre>
255
 
<p>
256
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">STRING</code> selection target.
257
 
</p>
258
 
</div>
259
 
<hr>
260
 
<div class="refsect2">
261
 
<a name="GDK-SELECTION-TYPE-ATOM:CAPS"></a><h3>GDK_SELECTION_TYPE_ATOM</h3>
262
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_ATOM     _GDK_MAKE_ATOM (4)
263
 
</pre>
264
 
<p>
265
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">ATOM</code> selection type.
266
 
</p>
267
 
</div>
268
 
<hr>
269
 
<div class="refsect2">
270
 
<a name="GDK-SELECTION-TYPE-BITMAP:CAPS"></a><h3>GDK_SELECTION_TYPE_BITMAP</h3>
271
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_BITMAP   _GDK_MAKE_ATOM (5)
272
 
</pre>
273
 
<p>
274
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">BITMAP</code> selection type.
275
 
</p>
276
 
</div>
277
 
<hr>
278
 
<div class="refsect2">
279
 
<a name="GDK-SELECTION-TYPE-COLORMAP:CAPS"></a><h3>GDK_SELECTION_TYPE_COLORMAP</h3>
280
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_COLORMAP         _GDK_MAKE_ATOM (7)
281
 
</pre>
282
 
<p>
283
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">COLORMAP</code> selection type.
284
 
</p>
285
 
</div>
286
 
<hr>
287
 
<div class="refsect2">
288
 
<a name="GDK-SELECTION-TYPE-DRAWABLE:CAPS"></a><h3>GDK_SELECTION_TYPE_DRAWABLE</h3>
289
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_DRAWABLE         _GDK_MAKE_ATOM (17)
290
 
</pre>
291
 
<p>
292
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">DRAWABLE</code> selection type.
293
 
</p>
294
 
</div>
295
 
<hr>
296
 
<div class="refsect2">
297
 
<a name="GDK-SELECTION-TYPE-INTEGER:CAPS"></a><h3>GDK_SELECTION_TYPE_INTEGER</h3>
298
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_INTEGER  _GDK_MAKE_ATOM (19)
299
 
</pre>
300
 
<p>
301
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">INTEGER</code> selection type.
302
 
</p>
303
 
</div>
304
 
<hr>
305
 
<div class="refsect2">
306
 
<a name="GDK-SELECTION-TYPE-PIXMAP:CAPS"></a><h3>GDK_SELECTION_TYPE_PIXMAP</h3>
307
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_PIXMAP   _GDK_MAKE_ATOM (20)
308
 
</pre>
309
 
<p>
310
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">PIXMAP</code> selection type.
311
 
</p>
312
 
</div>
313
 
<hr>
314
 
<div class="refsect2">
315
 
<a name="GDK-SELECTION-TYPE-WINDOW:CAPS"></a><h3>GDK_SELECTION_TYPE_WINDOW</h3>
316
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_WINDOW   _GDK_MAKE_ATOM (33)
317
 
</pre>
318
 
<p>
319
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">WINDOW</code> selection type.
320
 
</p>
321
 
</div>
322
 
<hr>
323
 
<div class="refsect2">
324
 
<a name="GDK-SELECTION-TYPE-STRING:CAPS"></a><h3>GDK_SELECTION_TYPE_STRING</h3>
325
 
<pre class="programlisting">#define GDK_SELECTION_TYPE_STRING   _GDK_MAKE_ATOM (31)
326
 
</pre>
327
 
<p>
328
 
A <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> representing the <code class="literal">STRING</code> selection type.
329
 
</p>
330
 
</div>
331
 
<hr>
332
 
<div class="refsect2">
333
 
<a name="gdk-selection-owner-set"></a><h3>gdk_selection_owner_set ()</h3>
334
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_selection_owner_set             (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
335
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
336
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
337
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);</pre>
338
 
<p>
339
 
Sets the owner of the given selection.
340
 
</p>
341
 
<div class="variablelist"><table border="0" class="variablelist">
342
 
<colgroup>
343
 
<col align="left" valign="top">
344
 
<col>
345
 
</colgroup>
346
 
<tbody>
347
 
<tr>
348
 
<td><p><span class="term"><em class="parameter"><code>owner</code></em> :</span></p></td>
349
 
<td>a <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> 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 the
350
 
the owner for the given should be unset.</td>
351
 
</tr>
352
 
<tr>
353
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
354
 
<td>an atom identifying a selection.</td>
355
 
</tr>
356
 
<tr>
357
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
358
 
<td>timestamp to use when setting the selection.
359
 
If this is older than the timestamp given last
360
 
time the owner was set for the given selection, the
361
 
request will be ignored.</td>
362
 
</tr>
363
 
<tr>
364
 
<td><p><span class="term"><em class="parameter"><code>send_event</code></em> :</span></p></td>
365
 
<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different
366
 
from the current owner, the current owner
367
 
will be sent a SelectionClear event.</td>
368
 
</tr>
369
 
<tr>
370
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
371
 
<td>
372
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection owner was successfully
373
 
changed to <em class="parameter"><code>owner</code></em>, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
374
 
</tr>
375
 
</tbody>
376
 
</table></div>
377
 
</div>
378
 
<hr>
379
 
<div class="refsect2">
380
 
<a name="gdk-selection-owner-set-for-display"></a><h3>gdk_selection_owner_set_for_display ()</h3>
381
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_selection_owner_set_for_display (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
382
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *owner</code></em>,
383
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
384
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>,
385
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> send_event</code></em>);</pre>
386
 
<p>
387
 
Sets the <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> <em class="parameter"><code>owner</code></em> as the current owner of the selection <em class="parameter"><code>selection</code></em>.
388
 
</p>
389
 
<div class="variablelist"><table border="0" class="variablelist">
390
 
<colgroup>
391
 
<col align="left" valign="top">
392
 
<col>
393
 
</colgroup>
394
 
<tbody>
395
 
<tr>
396
 
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
397
 
<td>the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>.</td>
398
 
</tr>
399
 
<tr>
400
 
<td><p><span class="term"><em class="parameter"><code>owner</code></em> :</span></p></td>
401
 
<td>a <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> 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 the owner for
402
 
the given should be unset.</td>
403
 
</tr>
404
 
<tr>
405
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
406
 
<td>an atom identifying a selection.</td>
407
 
</tr>
408
 
<tr>
409
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
410
 
<td>timestamp to use when setting the selection.
411
 
If this is older than the timestamp given last time the owner was
412
 
set for the given selection, the request will be ignored.</td>
413
 
</tr>
414
 
<tr>
415
 
<td><p><span class="term"><em class="parameter"><code>send_event</code></em> :</span></p></td>
416
 
<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and the new owner is different from the current
417
 
owner, the current owner will be sent a SelectionClear event.</td>
418
 
</tr>
419
 
<tr>
420
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
421
 
<td>
422
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the selection owner was successfully changed to owner,
423
 
otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
424
 
</tr>
425
 
</tbody>
426
 
</table></div>
427
 
<p class="since">Since 2.2</p>
428
 
</div>
429
 
<hr>
430
 
<div class="refsect2">
431
 
<a name="gdk-selection-owner-get"></a><h3>gdk_selection_owner_get ()</h3>
432
 
<pre class="programlisting"><a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_selection_owner_get             (<em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
433
 
<p>
434
 
Determines the owner of the given selection.
435
 
</p>
436
 
<div class="variablelist"><table border="0" class="variablelist">
437
 
<colgroup>
438
 
<col align="left" valign="top">
439
 
<col>
440
 
</colgroup>
441
 
<tbody>
442
 
<tr>
443
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
444
 
<td>an atom indentifying a selection.</td>
445
 
</tr>
446
 
<tr>
447
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
448
 
<td>if there is a selection owner for this window,
449
 
and it is a window known to the current process,
450
 
the <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the selection, otherwise
451
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Note that the return value may be owned
452
 
by a different process if a foreign window
453
 
was previously created for that window, but
454
 
a new foreign window will never be created by
455
 
this call.</td>
456
 
</tr>
457
 
</tbody>
458
 
</table></div>
459
 
</div>
460
 
<hr>
461
 
<div class="refsect2">
462
 
<a name="gdk-selection-owner-get-for-display"></a><h3>gdk_selection_owner_get_for_display ()</h3>
463
 
<pre class="programlisting"><a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_selection_owner_get_for_display (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
464
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
465
 
<p>
466
 
Determine the owner of the given selection.
467
 
</p>
468
 
<p>
469
 
Note that the return value may be owned by a different 
470
 
process if a foreign window was previously created for that
471
 
window, but a new foreign window will never be created by this call.
472
 
</p>
473
 
<div class="variablelist"><table border="0" class="variablelist">
474
 
<colgroup>
475
 
<col align="left" valign="top">
476
 
<col>
477
 
</colgroup>
478
 
<tbody>
479
 
<tr>
480
 
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
481
 
<td>a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>.</td>
482
 
</tr>
483
 
<tr>
484
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
485
 
<td>an atom indentifying a selection.</td>
486
 
</tr>
487
 
<tr>
488
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
489
 
<td>if there is a selection owner for this window, and it is a
490
 
window known to the current process, the <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> that owns the
491
 
selection, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
492
 
</tr>
493
 
</tbody>
494
 
</table></div>
495
 
<p class="since">Since 2.2</p>
496
 
</div>
497
 
<hr>
498
 
<div class="refsect2">
499
 
<a name="gdk-selection-convert"></a><h3>gdk_selection_convert ()</h3>
500
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_selection_convert               (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
501
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
502
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
503
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
504
 
<p>
505
 
Retrieves the contents of a selection in a given
506
 
form.
507
 
</p>
508
 
<div class="variablelist"><table border="0" class="variablelist">
509
 
<colgroup>
510
 
<col align="left" valign="top">
511
 
<col>
512
 
</colgroup>
513
 
<tbody>
514
 
<tr>
515
 
<td><p><span class="term"><em class="parameter"><code>requestor</code></em> :</span></p></td>
516
 
<td>a <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>.</td>
517
 
</tr>
518
 
<tr>
519
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
520
 
<td>an atom identifying the selection to get the
521
 
contents of.</td>
522
 
</tr>
523
 
<tr>
524
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
525
 
<td>the form in which to retrieve the selection.</td>
526
 
</tr>
527
 
<tr>
528
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
529
 
<td>the timestamp to use when retrieving the
530
 
selection. The selection owner may refuse the
531
 
request if it did not own the selection at
532
 
the time indicated by the timestamp.</td>
533
 
</tr>
534
 
</tbody>
535
 
</table></div>
536
 
</div>
537
 
<hr>
538
 
<div class="refsect2">
539
 
<a name="gdk-selection-property-get"></a><h3>gdk_selection_property_get ()</h3>
540
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_selection_property_get          (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *requestor</code></em>,
541
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **data</code></em>,
542
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *prop_type</code></em>,
543
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *prop_format</code></em>);</pre>
544
 
<p>
545
 
Retrieves selection data that was stored by the selection
546
 
data in response to a call to <a class="link" href="gdk-Selections.html#gdk-selection-convert" title="gdk_selection_convert ()"><code class="function">gdk_selection_convert()</code></a>. This function
547
 
will not be used by applications, who should use the <a href="http://library.gnome.org/devel/gtk3/gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a>
548
 
API instead.
549
 
</p>
550
 
<div class="variablelist"><table border="0" class="variablelist">
551
 
<colgroup>
552
 
<col align="left" valign="top">
553
 
<col>
554
 
</colgroup>
555
 
<tbody>
556
 
<tr>
557
 
<td><p><span class="term"><em class="parameter"><code>requestor</code></em> :</span></p></td>
558
 
<td>the window on which the data is stored</td>
559
 
</tr>
560
 
<tr>
561
 
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
562
 
<td>location to store a pointer to the retrieved data.
563
 
If the retrieval failed, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> we be stored here, otherwise, it
564
 
will be non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and the returned data should 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>
565
 
when you are finished using it. The length of the
566
 
allocated memory is one more than the length
567
 
of the returned data, and the final byte will always
568
 
be zero, to ensure nul-termination of strings.</td>
569
 
</tr>
570
 
<tr>
571
 
<td><p><span class="term"><em class="parameter"><code>prop_type</code></em> :</span></p></td>
572
 
<td>location to store the type of the property.</td>
573
 
</tr>
574
 
<tr>
575
 
<td><p><span class="term"><em class="parameter"><code>prop_format</code></em> :</span></p></td>
576
 
<td>location to store the format of the property.</td>
577
 
</tr>
578
 
<tr>
579
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
580
 
<td>the length of the retrieved data.</td>
581
 
</tr>
582
 
</tbody>
583
 
</table></div>
584
 
</div>
585
 
<hr>
586
 
<div class="refsect2">
587
 
<a name="gdk-selection-send-notify"></a><h3>gdk_selection_send_notify ()</h3>
588
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_selection_send_notify           (<em class="parameter"><code><a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> requestor</code></em>,
589
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
590
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
591
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
592
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
593
 
<p>
594
 
Sends a response to SelectionRequest event.
595
 
</p>
596
 
<div class="variablelist"><table border="0" class="variablelist">
597
 
<colgroup>
598
 
<col align="left" valign="top">
599
 
<col>
600
 
</colgroup>
601
 
<tbody>
602
 
<tr>
603
 
<td><p><span class="term"><em class="parameter"><code>requestor</code></em> :</span></p></td>
604
 
<td>window to which to deliver response.</td>
605
 
</tr>
606
 
<tr>
607
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
608
 
<td>selection that was requested.</td>
609
 
</tr>
610
 
<tr>
611
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
612
 
<td>target that was selected.</td>
613
 
</tr>
614
 
<tr>
615
 
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
616
 
<td>property in which the selection owner stored the
617
 
data, or <a class="link" href="gdk-Properties-and-Atoms.html#GDK-NONE:CAPS" title="GDK_NONE"><code class="literal">GDK_NONE</code></a> to indicate that the request
618
 
was rejected.</td>
619
 
</tr>
620
 
<tr>
621
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
622
 
<td>timestamp.</td>
623
 
</tr>
624
 
</tbody>
625
 
</table></div>
626
 
</div>
627
 
<hr>
628
 
<div class="refsect2">
629
 
<a name="gdk-selection-send-notify-for-display"></a><h3>gdk_selection_send_notify_for_display ()</h3>
630
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_selection_send_notify_for_display
631
 
                                                        (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
632
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> requestor</code></em>,
633
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>,
634
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> target</code></em>,
635
 
                                                         <em class="parameter"><code><a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>,
636
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
637
 
<p>
638
 
Send a response to SelectionRequest event.
639
 
</p>
640
 
<div class="variablelist"><table border="0" class="variablelist">
641
 
<colgroup>
642
 
<col align="left" valign="top">
643
 
<col>
644
 
</colgroup>
645
 
<tbody>
646
 
<tr>
647
 
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
648
 
<td>the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where <em class="parameter"><code>requestor</code></em> is realized</td>
649
 
</tr>
650
 
<tr>
651
 
<td><p><span class="term"><em class="parameter"><code>requestor</code></em> :</span></p></td>
652
 
<td>window to which to deliver response.</td>
653
 
</tr>
654
 
<tr>
655
 
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
656
 
<td>selection that was requested.</td>
657
 
</tr>
658
 
<tr>
659
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
660
 
<td>target that was selected.</td>
661
 
</tr>
662
 
<tr>
663
 
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
664
 
<td>property in which the selection owner stored the data,
665
 
or <a class="link" href="gdk-Properties-and-Atoms.html#GDK-NONE:CAPS" title="GDK_NONE"><code class="literal">GDK_NONE</code></a> to indicate that the request was rejected.</td>
666
 
</tr>
667
 
<tr>
668
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
669
 
<td>timestamp.</td>
670
 
</tr>
671
 
</tbody>
672
 
</table></div>
673
 
<p class="since">Since 2.2</p>
674
 
</div>
675
 
</div>
676
 
</div>
677
 
<div class="footer">
678
 
<hr>
679
 
          Generated by GTK-Doc V1.18.1</div>
680
 
</body>
681
 
</html>
 
 
b'\\ No newline at end of file'