← Back to branch summary

~inkscape.dev/inkscape-devlibs/devlibs-gtk3

« back to all changes in this revision

Viewing changes to share/gtk-doc/html/gdk2/gdk2-Drag-and-Drop.html

  • Committer: JazzyNico
  • Date: 2013-01-21 10:11:05 UTC
  • Revision ID: nicoduf@yahoo.fr-20130121101105-i8d8slkq9ng4olx8
Adding gtk2 libraries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
share/gtk-doc/html/gdk2/gdk2-Drag-and-Drop.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>Drag and Drop</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="gdk2-Selections.html" title="Selections">
 
10
<link rel="next" href="gdk2-Properties-and-Atoms.html" title="Properties and Atoms">
 
11
<meta name="generator" content="GTK-Doc V1.18 (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="gdk2-Selections.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="gdk2-Properties-and-Atoms.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="#gdk2-Drag-and-Drop.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#gdk2-Drag-and-Drop.description" class="shortcut">Description</a>
 
27
</td></tr>
 
28
</table>
 
29
<div class="refentry">
 
30
<a name="gdk2-Drag-and-Drop"></a><div class="titlepage"></div>
 
31
<div class="refnamediv"><table width="100%"><tr>
 
32
<td valign="top">
 
33
<h2><span class="refentrytitle"><a name="gdk2-Drag-and-Drop.top_of_page"></a>Drag and Drop</span></h2>
 
34
<p>Drag and Drop — Functions for controlling drag and drop handling</p>
 
35
</td>
 
36
<td valign="top" align="right"></td>
 
37
</tr></table></div>
 
38
<div class="refsynopsisdiv">
 
39
<a name="gdk2-Drag-and-Drop.synopsis"></a><h2>Synopsis</h2>
 
40
<pre class="synopsis">
 
41
#include &lt;gdk/gdk.h&gt;
 
42
 
 
43
<a class="link" href="gdk2-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-get-selection" title="gdk_drag_get_selection ()">gdk_drag_get_selection</a>              (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
44
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-abort" title="gdk_drag_abort ()">gdk_drag_abort</a>                      (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
45
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
46
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drop-reply" title="gdk_drop_reply ()">gdk_drop_reply</a>                      (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
47
                                                         <em class="parameter"><code><span class="type">gboolean</span> ok</code></em>,
 
48
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
49
<a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-new" title="gdk_drag_context_new ()">gdk_drag_context_new</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
 
50
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-drop" title="gdk_drag_drop ()">gdk_drag_drop</a>                       (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
51
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
52
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-find-window" title="gdk_drag_find_window ()">gdk_drag_find_window</a>                (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
53
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
 
54
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
55
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
56
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
 
57
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
 
58
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-find-window-for-screen" title="gdk_drag_find_window_for_screen ()">gdk_drag_find_window_for_screen</a>     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
59
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
 
60
                                                         <em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
 
61
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
62
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
63
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
 
64
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
 
65
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-ref" title="gdk_drag_context_ref ()">gdk_drag_context_ref</a>                (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
66
<a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-get-actions" title="gdk_drag_context_get_actions ()">gdk_drag_context_get_actions</a>        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
67
<a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-get-selected-action" title="gdk_drag_context_get_selected_action ()">gdk_drag_context_get_selected_action</a>
 
68
                                                        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
69
<a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-get-suggested-action" title="gdk_drag_context_get_suggested_action ()">gdk_drag_context_get_suggested_action</a>
 
70
                                                        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
71
<span class="returnvalue">GList</span> *             <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-list-targets" title="gdk_drag_context_list_targets ()">gdk_drag_context_list_targets</a>       (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
72
<a class="link" href="gdk2-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-get-source-window" title="gdk_drag_context_get_source_window ()">gdk_drag_context_get_source_window</a>  (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
73
<a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-begin" title="gdk_drag_begin ()">gdk_drag_begin</a>                      (<em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
 
74
                                                         <em class="parameter"><code><span class="type">GList</span> *targets</code></em>);
 
75
<span class="returnvalue">gboolean</span>            <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()">gdk_drag_motion</a>                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
76
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *dest_window</code></em>,
 
77
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> protocol</code></em>,
 
78
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
79
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
80
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> suggested_action</code></em>,
 
81
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> possible_actions</code></em>,
 
82
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
83
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drop-finish" title="gdk_drop_finish ()">gdk_drop_finish</a>                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
84
                                                         <em class="parameter"><code><span class="type">gboolean</span> success</code></em>,
 
85
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
86
<a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-get-protocol" title="gdk_drag_get_protocol ()">gdk_drag_get_protocol</a>               (<em class="parameter"><code><a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> xid</code></em>,
 
87
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
 
88
<a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-get-protocol-for-display" title="gdk_drag_get_protocol_for_display ()">gdk_drag_get_protocol_for_display</a>   (<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="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> xid</code></em>,
 
90
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
 
91
enum                <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol">GdkDragProtocol</a>;
 
92
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-context-unref" title="gdk_drag_context_unref ()">gdk_drag_context_unref</a>              (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
93
struct              <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext">GdkDragContext</a>;
 
94
enum                <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction">GdkDragAction</a>;
 
95
<span class="returnvalue">void</span>                <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-status" title="gdk_drag_status ()">gdk_drag_status</a>                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
96
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> action</code></em>,
 
97
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
 
98
<span class="returnvalue">gboolean</span>            <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-drop-succeeded" title="gdk_drag_drop_succeeded ()">gdk_drag_drop_succeeded</a>             (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
99
</pre>
 
100
</div>
 
101
<div class="refsect1">
 
102
<a name="gdk2-Drag-and-Drop.description"></a><h2>Description</h2>
 
103
<p>
 
104
These functions provide a low level interface for drag and drop.
 
105
The X backend of GDK supports both the Xdnd and Motif drag and drop protocols
 
106
transparently, the Win32 backend supports the WM_DROPFILES protocol.
 
107
</p>
 
108
<p>
 
109
GTK+ provides a higher level abstraction based on top of these functions,
 
110
and so they are not normally needed in GTK+ applications.
 
111
See the Drag and Drop section of
 
112
the GTK+ documentation for more information.
 
113
</p>
 
114
</div>
 
115
<div class="refsect1">
 
116
<a name="gdk2-Drag-and-Drop.details"></a><h2>Details</h2>
 
117
<div class="refsect2">
 
118
<a name="gdk-drag-get-selection"></a><h3>gdk_drag_get_selection ()</h3>
 
119
<pre class="programlisting"><a class="link" href="gdk2-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             gdk_drag_get_selection              (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
120
<p>
 
121
Returns the selection atom for the current source window.
 
122
</p>
 
123
<div class="variablelist"><table border="0" class="variablelist">
 
124
<colgroup>
 
125
<col align="left" valign="top">
 
126
<col>
 
127
</colgroup>
 
128
<tbody>
 
129
<tr>
 
130
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
131
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
132
</tr>
 
133
<tr>
 
134
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
135
<td>the selection atom.</td>
 
136
</tr>
 
137
</tbody>
 
138
</table></div>
 
139
</div>
 
140
<hr>
 
141
<div class="refsect2">
 
142
<a name="gdk-drag-abort"></a><h3>gdk_drag_abort ()</h3>
 
143
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_abort                      (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
144
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
145
<p>
 
146
Aborts a drag without dropping. 
 
147
</p>
 
148
<p>
 
149
This function is called by the drag source.
 
150
</p>
 
151
<div class="variablelist"><table border="0" class="variablelist">
 
152
<colgroup>
 
153
<col align="left" valign="top">
 
154
<col>
 
155
</colgroup>
 
156
<tbody>
 
157
<tr>
 
158
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
159
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
160
</tr>
 
161
<tr>
 
162
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
163
<td>the timestamp for this operation.</td>
 
164
</tr>
 
165
</tbody>
 
166
</table></div>
 
167
</div>
 
168
<hr>
 
169
<div class="refsect2">
 
170
<a name="gdk-drop-reply"></a><h3>gdk_drop_reply ()</h3>
 
171
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drop_reply                      (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
172
                                                         <em class="parameter"><code><span class="type">gboolean</span> ok</code></em>,
 
173
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
174
<p>
 
175
Accepts or rejects a drop. 
 
176
</p>
 
177
<p>
 
178
This function is called by the drag destination in response
 
179
to a drop initiated by the drag source.
 
180
</p>
 
181
<div class="variablelist"><table border="0" class="variablelist">
 
182
<colgroup>
 
183
<col align="left" valign="top">
 
184
<col>
 
185
</colgroup>
 
186
<tbody>
 
187
<tr>
 
188
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
189
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
190
</tr>
 
191
<tr>
 
192
<td><p><span class="term"><em class="parameter"><code>ok</code></em> :</span></p></td>
 
193
<td>
 
194
<code class="literal">TRUE</code> if the drop is accepted.</td>
 
195
</tr>
 
196
<tr>
 
197
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
198
<td>the timestamp for this operation.</td>
 
199
</tr>
 
200
</tbody>
 
201
</table></div>
 
202
</div>
 
203
<hr>
 
204
<div class="refsect2">
 
205
<a name="gdk-drag-context-new"></a><h3>gdk_drag_context_new ()</h3>
 
206
<pre class="programlisting"><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    gdk_drag_context_new                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
207
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
208
<h3 class="title">Warning</h3>
 
209
<p><code class="literal">gdk_drag_context_new</code> has been deprecated since version 2.24 and should not be used in newly-written code. This function is not useful, you always
 
210
  obtain drag contexts by <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-begin" title="gdk_drag_begin ()"><code class="function">gdk_drag_begin()</code></a> or similar.</p>
 
211
</div>
 
212
<p>
 
213
Creates a new <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.
 
214
</p>
 
215
<div class="variablelist"><table border="0" class="variablelist">
 
216
<colgroup>
 
217
<col align="left" valign="top">
 
218
<col>
 
219
</colgroup>
 
220
<tbody><tr>
 
221
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
222
<td>the newly created <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
223
</tr></tbody>
 
224
</table></div>
 
225
</div>
 
226
<hr>
 
227
<div class="refsect2">
 
228
<a name="gdk-drag-drop"></a><h3>gdk_drag_drop ()</h3>
 
229
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_drop                       (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
230
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
231
<p>
 
232
Drops on the current destination.
 
233
</p>
 
234
<p>
 
235
This function is called by the drag source.
 
236
</p>
 
237
<div class="variablelist"><table border="0" class="variablelist">
 
238
<colgroup>
 
239
<col align="left" valign="top">
 
240
<col>
 
241
</colgroup>
 
242
<tbody>
 
243
<tr>
 
244
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
245
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
246
</tr>
 
247
<tr>
 
248
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
249
<td>the timestamp for this operation.</td>
 
250
</tr>
 
251
</tbody>
 
252
</table></div>
 
253
</div>
 
254
<hr>
 
255
<div class="refsect2">
 
256
<a name="gdk-drag-find-window"></a><h3>gdk_drag_find_window ()</h3>
 
257
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_find_window                (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
258
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
 
259
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
260
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
261
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
 
262
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
 
263
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
264
<h3 class="title">Warning</h3>
 
265
<p><code class="literal">gdk_drag_find_window</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-find-window-for-screen" title="gdk_drag_find_window_for_screen ()"><code class="function">gdk_drag_find_window_for_screen()</code></a> instead.</p>
 
266
</div>
 
267
<p>
 
268
Finds the destination window and DND protocol to use at the
 
269
given pointer position.
 
270
</p>
 
271
<p>
 
272
This function is called by the drag source to obtain the 
 
273
<em class="parameter"><code>dest_window</code></em> and <em class="parameter"><code>protocol</code></em> parameters for <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()"><code class="function">gdk_drag_motion()</code></a>.
 
274
</p>
 
275
<div class="variablelist"><table border="0" class="variablelist">
 
276
<colgroup>
 
277
<col align="left" valign="top">
 
278
<col>
 
279
</colgroup>
 
280
<tbody>
 
281
<tr>
 
282
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
283
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
284
</tr>
 
285
<tr>
 
286
<td><p><span class="term"><em class="parameter"><code>drag_window</code></em> :</span></p></td>
 
287
<td>a window which may be at the pointer position, but
 
288
should be ignored, since it is put up by the drag source as an icon.</td>
 
289
</tr>
 
290
<tr>
 
291
<td><p><span class="term"><em class="parameter"><code>x_root</code></em> :</span></p></td>
 
292
<td>the x position of the pointer in root coordinates.</td>
 
293
</tr>
 
294
<tr>
 
295
<td><p><span class="term"><em class="parameter"><code>y_root</code></em> :</span></p></td>
 
296
<td>the y position of the pointer in root coordinates.</td>
 
297
</tr>
 
298
<tr>
 
299
<td><p><span class="term"><em class="parameter"><code>dest_window</code></em> :</span></p></td>
 
300
<td>location to store the destination window in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
301
</td>
 
302
</tr>
 
303
<tr>
 
304
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
 
305
<td>location to store the DND protocol in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
306
</td>
 
307
</tr>
 
308
</tbody>
 
309
</table></div>
 
310
</div>
 
311
<hr>
 
312
<div class="refsect2">
 
313
<a name="gdk-drag-find-window-for-screen"></a><h3>gdk_drag_find_window_for_screen ()</h3>
 
314
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_find_window_for_screen     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
315
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
 
316
                                                         <em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
 
317
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
318
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
319
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
 
320
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
 
321
<p>
 
322
Finds the destination window and DND protocol to use at the
 
323
given pointer position.
 
324
</p>
 
325
<p>
 
326
This function is called by the drag source to obtain the 
 
327
<em class="parameter"><code>dest_window</code></em> and <em class="parameter"><code>protocol</code></em> parameters for <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()"><code class="function">gdk_drag_motion()</code></a>.
 
328
</p>
 
329
<div class="variablelist"><table border="0" class="variablelist">
 
330
<colgroup>
 
331
<col align="left" valign="top">
 
332
<col>
 
333
</colgroup>
 
334
<tbody>
 
335
<tr>
 
336
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
337
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
338
</td>
 
339
</tr>
 
340
<tr>
 
341
<td><p><span class="term"><em class="parameter"><code>drag_window</code></em> :</span></p></td>
 
342
<td>a window which may be at the pointer position, but
 
343
should be ignored, since it is put up by the drag source as an icon.</td>
 
344
</tr>
 
345
<tr>
 
346
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 
347
<td>the screen where the destination window is sought.</td>
 
348
</tr>
 
349
<tr>
 
350
<td><p><span class="term"><em class="parameter"><code>x_root</code></em> :</span></p></td>
 
351
<td>the x position of the pointer in root coordinates.</td>
 
352
</tr>
 
353
<tr>
 
354
<td><p><span class="term"><em class="parameter"><code>y_root</code></em> :</span></p></td>
 
355
<td>the y position of the pointer in root coordinates.</td>
 
356
</tr>
 
357
<tr>
 
358
<td><p><span class="term"><em class="parameter"><code>dest_window</code></em> :</span></p></td>
 
359
<td>location to store the destination window in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
360
</td>
 
361
</tr>
 
362
<tr>
 
363
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
 
364
<td>location to store the DND protocol in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
365
</td>
 
366
</tr>
 
367
</tbody>
 
368
</table></div>
 
369
<p class="since">Since 2.2</p>
 
370
</div>
 
371
<hr>
 
372
<div class="refsect2">
 
373
<a name="gdk-drag-context-ref"></a><h3>gdk_drag_context_ref ()</h3>
 
374
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_context_ref                (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
375
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
376
<h3 class="title">Warning</h3>
 
377
<p><code class="literal">gdk_drag_context_ref</code> has been deprecated since version 2.2 and should not be used in newly-written code. Use <code class="function">g_object_ref()</code> instead.</p>
 
378
</div>
 
379
<p>
 
380
Deprecated function; use <code class="function">g_object_ref()</code> instead.
 
381
</p>
 
382
<div class="variablelist"><table border="0" class="variablelist">
 
383
<colgroup>
 
384
<col align="left" valign="top">
 
385
<col>
 
386
</colgroup>
 
387
<tbody><tr>
 
388
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
389
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
390
</tr></tbody>
 
391
</table></div>
 
392
</div>
 
393
<hr>
 
394
<div class="refsect2">
 
395
<a name="gdk-drag-context-get-actions"></a><h3>gdk_drag_context_get_actions ()</h3>
 
396
<pre class="programlisting"><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       gdk_drag_context_get_actions        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
397
<p>
 
398
Determines the bitmask of actions proposed by the source if
 
399
<code class="function">gdk_drag_context_suggested_action()</code> returns GDK_ACTION_ASK.
 
400
</p>
 
401
<div class="variablelist"><table border="0" class="variablelist">
 
402
<colgroup>
 
403
<col align="left" valign="top">
 
404
<col>
 
405
</colgroup>
 
406
<tbody>
 
407
<tr>
 
408
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
409
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
410
</td>
 
411
</tr>
 
412
<tr>
 
413
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
414
<td>the <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> flags</td>
 
415
</tr>
 
416
</tbody>
 
417
</table></div>
 
418
<p class="since">Since 2.22</p>
 
419
</div>
 
420
<hr>
 
421
<div class="refsect2">
 
422
<a name="gdk-drag-context-get-selected-action"></a><h3>gdk_drag_context_get_selected_action ()</h3>
 
423
<pre class="programlisting"><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       gdk_drag_context_get_selected_action
 
424
                                                        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
425
<p>
 
426
Determines the action chosen by the drag destination.
 
427
</p>
 
428
<div class="variablelist"><table border="0" class="variablelist">
 
429
<colgroup>
 
430
<col align="left" valign="top">
 
431
<col>
 
432
</colgroup>
 
433
<tbody>
 
434
<tr>
 
435
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
436
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
437
</td>
 
438
</tr>
 
439
<tr>
 
440
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
441
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> value</td>
 
442
</tr>
 
443
</tbody>
 
444
</table></div>
 
445
<p class="since">Since 2.22</p>
 
446
</div>
 
447
<hr>
 
448
<div class="refsect2">
 
449
<a name="gdk-drag-context-get-suggested-action"></a><h3>gdk_drag_context_get_suggested_action ()</h3>
 
450
<pre class="programlisting"><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       gdk_drag_context_get_suggested_action
 
451
                                                        (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
452
<p>
 
453
Determines the suggested drag action of the context.
 
454
</p>
 
455
<div class="variablelist"><table border="0" class="variablelist">
 
456
<colgroup>
 
457
<col align="left" valign="top">
 
458
<col>
 
459
</colgroup>
 
460
<tbody>
 
461
<tr>
 
462
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
463
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
464
</td>
 
465
</tr>
 
466
<tr>
 
467
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
468
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> value</td>
 
469
</tr>
 
470
</tbody>
 
471
</table></div>
 
472
<p class="since">Since 2.22</p>
 
473
</div>
 
474
<hr>
 
475
<div class="refsect2">
 
476
<a name="gdk-drag-context-list-targets"></a><h3>gdk_drag_context_list_targets ()</h3>
 
477
<pre class="programlisting"><span class="returnvalue">GList</span> *             gdk_drag_context_list_targets       (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
478
<p>
 
479
Retrieves the list of targets of the context.
 
480
</p>
 
481
<div class="variablelist"><table border="0" class="variablelist">
 
482
<colgroup>
 
483
<col align="left" valign="top">
 
484
<col>
 
485
</colgroup>
 
486
<tbody>
 
487
<tr>
 
488
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
489
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
490
</td>
 
491
</tr>
 
492
<tr>
 
493
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
494
<td>a <span class="type">GList</span> of targets. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkAtom]</span>
 
495
</td>
 
496
</tr>
 
497
</tbody>
 
498
</table></div>
 
499
<p class="since">Since 2.22</p>
 
500
</div>
 
501
<hr>
 
502
<div class="refsect2">
 
503
<a name="gdk-drag-context-get-source-window"></a><h3>gdk_drag_context_get_source_window ()</h3>
 
504
<pre class="programlisting"><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_drag_context_get_source_window  (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
505
<p>
 
506
Returns the <a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> where the DND operation started.
 
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>context</code></em> :</span></p></td>
 
516
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
517
</td>
 
518
</tr>
 
519
<tr>
 
520
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
521
<td>a <a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
522
</td>
 
523
</tr>
 
524
</tbody>
 
525
</table></div>
 
526
<p class="since">Since 2.22</p>
 
527
</div>
 
528
<hr>
 
529
<div class="refsect2">
 
530
<a name="gdk-drag-begin"></a><h3>gdk_drag_begin ()</h3>
 
531
<pre class="programlisting"><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    gdk_drag_begin                      (<em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
 
532
                                                         <em class="parameter"><code><span class="type">GList</span> *targets</code></em>);</pre>
 
533
<p>
 
534
Starts a drag and creates a new drag context for it.
 
535
</p>
 
536
<p>
 
537
This function is called by the drag source.
 
538
</p>
 
539
<div class="variablelist"><table border="0" class="variablelist">
 
540
<colgroup>
 
541
<col align="left" valign="top">
 
542
<col>
 
543
</colgroup>
 
544
<tbody>
 
545
<tr>
 
546
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
 
547
<td>the source window for this drag.</td>
 
548
</tr>
 
549
<tr>
 
550
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
 
551
<td>the offered targets,
 
552
as list of <a class="link" href="gdk2-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>s. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkAtom]</span>
 
553
</td>
 
554
</tr>
 
555
<tr>
 
556
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
557
<td>a newly created <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
558
</tr>
 
559
</tbody>
 
560
</table></div>
 
561
</div>
 
562
<hr>
 
563
<div class="refsect2">
 
564
<a name="gdk-drag-motion"></a><h3>gdk_drag_motion ()</h3>
 
565
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_drag_motion                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
566
                                                         <em class="parameter"><code><a class="link" href="gdk2-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *dest_window</code></em>,
 
567
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> protocol</code></em>,
 
568
                                                         <em class="parameter"><code><span class="type">gint</span> x_root</code></em>,
 
569
                                                         <em class="parameter"><code><span class="type">gint</span> y_root</code></em>,
 
570
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> suggested_action</code></em>,
 
571
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> possible_actions</code></em>,
 
572
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
573
<p>
 
574
Updates the drag context when the pointer moves or the 
 
575
set of actions changes.
 
576
</p>
 
577
<p>
 
578
This function is called by the drag source.
 
579
</p>
 
580
<div class="variablelist"><table border="0" class="variablelist">
 
581
<colgroup>
 
582
<col align="left" valign="top">
 
583
<col>
 
584
</colgroup>
 
585
<tbody>
 
586
<tr>
 
587
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
588
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
589
</tr>
 
590
<tr>
 
591
<td><p><span class="term"><em class="parameter"><code>dest_window</code></em> :</span></p></td>
 
592
<td>the new destination window, obtained by
 
593
<a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-find-window" title="gdk_drag_find_window ()"><code class="function">gdk_drag_find_window()</code></a>.</td>
 
594
</tr>
 
595
<tr>
 
596
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
 
597
<td>the DND protocol in use, obtained by <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-find-window" title="gdk_drag_find_window ()"><code class="function">gdk_drag_find_window()</code></a>.</td>
 
598
</tr>
 
599
<tr>
 
600
<td><p><span class="term"><em class="parameter"><code>x_root</code></em> :</span></p></td>
 
601
<td>the x position of the pointer in root coordinates.</td>
 
602
</tr>
 
603
<tr>
 
604
<td><p><span class="term"><em class="parameter"><code>y_root</code></em> :</span></p></td>
 
605
<td>the y position of the pointer in root coordinates.</td>
 
606
</tr>
 
607
<tr>
 
608
<td><p><span class="term"><em class="parameter"><code>suggested_action</code></em> :</span></p></td>
 
609
<td>the suggested action.</td>
 
610
</tr>
 
611
<tr>
 
612
<td><p><span class="term"><em class="parameter"><code>possible_actions</code></em> :</span></p></td>
 
613
<td>the possible actions.</td>
 
614
</tr>
 
615
<tr>
 
616
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
617
<td>the timestamp for this operation.</td>
 
618
</tr>
 
619
<tr>
 
620
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
621
<td>FIXME</td>
 
622
</tr>
 
623
</tbody>
 
624
</table></div>
 
625
</div>
 
626
<hr>
 
627
<div class="refsect2">
 
628
<a name="gdk-drop-finish"></a><h3>gdk_drop_finish ()</h3>
 
629
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drop_finish                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
630
                                                         <em class="parameter"><code><span class="type">gboolean</span> success</code></em>,
 
631
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
632
<p>
 
633
Ends the drag operation after a drop.
 
634
</p>
 
635
<p>
 
636
This function is called by the drag destination.
 
637
</p>
 
638
<div class="variablelist"><table border="0" class="variablelist">
 
639
<colgroup>
 
640
<col align="left" valign="top">
 
641
<col>
 
642
</colgroup>
 
643
<tbody>
 
644
<tr>
 
645
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
646
<td>a <span class="type">GtkDragContext</span>.</td>
 
647
</tr>
 
648
<tr>
 
649
<td><p><span class="term"><em class="parameter"><code>success</code></em> :</span></p></td>
 
650
<td>
 
651
<code class="literal">TRUE</code> if the data was successfully received.</td>
 
652
</tr>
 
653
<tr>
 
654
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
655
<td>the timestamp for this operation.</td>
 
656
</tr>
 
657
</tbody>
 
658
</table></div>
 
659
</div>
 
660
<hr>
 
661
<div class="refsect2">
 
662
<a name="gdk-drag-get-protocol"></a><h3>gdk_drag_get_protocol ()</h3>
 
663
<pre class="programlisting"><a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     gdk_drag_get_protocol               (<em class="parameter"><code><a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> xid</code></em>,
 
664
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
 
665
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
666
<h3 class="title">Warning</h3>
 
667
<p><code class="literal">gdk_drag_get_protocol</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-get-protocol-for-display" title="gdk_drag_get_protocol_for_display ()"><code class="function">gdk_drag_get_protocol_for_display()</code></a> instead</p>
 
668
</div>
 
669
<p>
 
670
Finds out the DND protocol supported by a window.
 
671
</p>
 
672
<div class="variablelist"><table border="0" class="variablelist">
 
673
<colgroup>
 
674
<col align="left" valign="top">
 
675
<col>
 
676
</colgroup>
 
677
<tbody>
 
678
<tr>
 
679
<td><p><span class="term"><em class="parameter"><code>xid</code></em> :</span></p></td>
 
680
<td>the windowing system id of the destination window.</td>
 
681
</tr>
 
682
<tr>
 
683
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
 
684
<td>location where the supported DND protocol is returned.</td>
 
685
</tr>
 
686
<tr>
 
687
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
688
<td>the windowing system specific id for the window where
 
689
the drop should happen. This may be <em class="parameter"><code>xid</code></em> or the id of a proxy
 
690
window, or zero if <em class="parameter"><code>xid</code></em> doesn't support Drag and Drop.</td>
 
691
</tr>
 
692
</tbody>
 
693
</table></div>
 
694
</div>
 
695
<hr>
 
696
<div class="refsect2">
 
697
<a name="gdk-drag-get-protocol-for-display"></a><h3>gdk_drag_get_protocol_for_display ()</h3>
 
698
<pre class="programlisting"><a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     gdk_drag_get_protocol_for_display   (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
 
699
                                                         <em class="parameter"><code><a class="link" href="gdk2-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> xid</code></em>,
 
700
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
 
701
<p>
 
702
Finds out the DND protocol supported by a window.
 
703
</p>
 
704
<div class="variablelist"><table border="0" class="variablelist">
 
705
<colgroup>
 
706
<col align="left" valign="top">
 
707
<col>
 
708
</colgroup>
 
709
<tbody>
 
710
<tr>
 
711
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
 
712
<td>the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where the destination window resides</td>
 
713
</tr>
 
714
<tr>
 
715
<td><p><span class="term"><em class="parameter"><code>xid</code></em> :</span></p></td>
 
716
<td>the windowing system id of the destination window.</td>
 
717
</tr>
 
718
<tr>
 
719
<td><p><span class="term"><em class="parameter"><code>protocol</code></em> :</span></p></td>
 
720
<td>location where the supported DND protocol is returned.</td>
 
721
</tr>
 
722
<tr>
 
723
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
724
<td>the windowing system id of the window where the drop should happen. This
 
725
may be <em class="parameter"><code>xid</code></em> or the id of a proxy window, or zero if <em class="parameter"><code>xid</code></em> doesn't
 
726
support Drag and Drop.</td>
 
727
</tr>
 
728
</tbody>
 
729
</table></div>
 
730
<p class="since">Since 2.2</p>
 
731
</div>
 
732
<hr>
 
733
<div class="refsect2">
 
734
<a name="GdkDragProtocol"></a><h3>enum GdkDragProtocol</h3>
 
735
<pre class="programlisting">typedef enum {
 
736
  GDK_DRAG_PROTO_MOTIF,
 
737
  GDK_DRAG_PROTO_XDND,
 
738
  GDK_DRAG_PROTO_ROOTWIN,         /* A root window with nobody claiming
 
739
                                   * drags */
 
740
  GDK_DRAG_PROTO_NONE,            /* Not a valid drag window */
 
741
  GDK_DRAG_PROTO_WIN32_DROPFILES, /* The simple WM_DROPFILES dnd */
 
742
  GDK_DRAG_PROTO_OLE2,            /* The complex OLE2 dnd (not implemented) */
 
743
  GDK_DRAG_PROTO_LOCAL            /* Intra-app */
 
744
} GdkDragProtocol;
 
745
</pre>
 
746
<p>
 
747
Used in <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> to indicate the protocol according to
 
748
which DND is done.
 
749
</p>
 
750
<div class="variablelist"><table border="0" class="variablelist">
 
751
<colgroup>
 
752
<col align="left" valign="top">
 
753
<col>
 
754
</colgroup>
 
755
<tbody>
 
756
<tr>
 
757
<td><p><a name="GDK-DRAG-PROTO-MOTIF:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_MOTIF</code></span></p></td>
 
758
<td>The Motif DND protocol.
 
759
</td>
 
760
</tr>
 
761
<tr>
 
762
<td><p><a name="GDK-DRAG-PROTO-XDND:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_XDND</code></span></p></td>
 
763
<td>The Xdnd protocol.
 
764
</td>
 
765
</tr>
 
766
<tr>
 
767
<td><p><a name="GDK-DRAG-PROTO-ROOTWIN:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_ROOTWIN</code></span></p></td>
 
768
<td>An extension to the Xdnd protocol for
 
769
  unclaimed root window drops.
 
770
</td>
 
771
</tr>
 
772
<tr>
 
773
<td><p><a name="GDK-DRAG-PROTO-NONE:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_NONE</code></span></p></td>
 
774
<td>no protocol.
 
775
</td>
 
776
</tr>
 
777
<tr>
 
778
<td><p><a name="GDK-DRAG-PROTO-WIN32-DROPFILES:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_WIN32_DROPFILES</code></span></p></td>
 
779
<td>The simple WM_DROPFILES protocol.
 
780
</td>
 
781
</tr>
 
782
<tr>
 
783
<td><p><a name="GDK-DRAG-PROTO-OLE2:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_OLE2</code></span></p></td>
 
784
<td>The complex OLE2 DND protocol (not implemented).
 
785
</td>
 
786
</tr>
 
787
<tr>
 
788
<td><p><a name="GDK-DRAG-PROTO-LOCAL:CAPS"></a><span class="term"><code class="literal">GDK_DRAG_PROTO_LOCAL</code></span></p></td>
 
789
<td>Intra-application DND.
 
790
</td>
 
791
</tr>
 
792
</tbody>
 
793
</table></div>
 
794
</div>
 
795
<hr>
 
796
<div class="refsect2">
 
797
<a name="gdk-drag-context-unref"></a><h3>gdk_drag_context_unref ()</h3>
 
798
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_context_unref              (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
799
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
800
<h3 class="title">Warning</h3>
 
801
<p><code class="literal">gdk_drag_context_unref</code> has been deprecated since version 2.2 and should not be used in newly-written code. Use <code class="function">g_object_unref()</code> instead.</p>
 
802
</div>
 
803
<p>
 
804
Deprecated function; use <code class="function">g_object_unref()</code> instead.
 
805
</p>
 
806
<div class="variablelist"><table border="0" class="variablelist">
 
807
<colgroup>
 
808
<col align="left" valign="top">
 
809
<col>
 
810
</colgroup>
 
811
<tbody><tr>
 
812
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
813
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
814
</tr></tbody>
 
815
</table></div>
 
816
</div>
 
817
<hr>
 
818
<div class="refsect2">
 
819
<a name="GdkDragContext"></a><h3>struct GdkDragContext</h3>
 
820
<pre class="programlisting">struct GdkDragContext {
 
821
  GObject parent_instance;
 
822
 
 
823
  
 
824
  GdkDragProtocol GSEAL (protocol);
 
825
 
 
826
  gboolean GSEAL (is_source);
 
827
  
 
828
  GdkWindow *GSEAL (source_window);
 
829
  GdkWindow *GSEAL (dest_window);
 
830
 
 
831
  GList *GSEAL (targets);
 
832
  GdkDragAction GSEAL (actions);
 
833
  GdkDragAction GSEAL (suggested_action);
 
834
  GdkDragAction GSEAL (action);
 
835
 
 
836
  guint32 GSEAL (start_time);
 
837
};
 
838
</pre>
 
839
<p>
 
840
A <span class="structname">GdkDragContext</span> holds information about a
 
841
drag in progress. It is used on both source and destination sides.
 
842
</p>
 
843
<div class="variablelist"><table border="0" class="variablelist">
 
844
<colgroup>
 
845
<col align="left" valign="top">
 
846
<col>
 
847
</colgroup>
 
848
<tbody><tr>
 
849
<td><p><span class="term"><span class="type">GObject</span> <em class="structfield"><code><a name="GdkDragContext.parent-instance"></a>parent_instance</code></em>;</span></p></td>
 
850
<td>the parent instance</td>
 
851
</tr></tbody>
 
852
</table></div>
 
853
</div>
 
854
<hr>
 
855
<div class="refsect2">
 
856
<a name="GdkDragAction"></a><h3>enum GdkDragAction</h3>
 
857
<pre class="programlisting">typedef enum {
 
858
  GDK_ACTION_DEFAULT = 1 &lt;&lt; 0,
 
859
  GDK_ACTION_COPY    = 1 &lt;&lt; 1,
 
860
  GDK_ACTION_MOVE    = 1 &lt;&lt; 2,
 
861
  GDK_ACTION_LINK    = 1 &lt;&lt; 3,
 
862
  GDK_ACTION_PRIVATE = 1 &lt;&lt; 4,
 
863
  GDK_ACTION_ASK     = 1 &lt;&lt; 5
 
864
} GdkDragAction;
 
865
</pre>
 
866
<p>
 
867
Used in <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> to indicate what the destination
 
868
should do with the dropped data.
 
869
</p>
 
870
<div class="variablelist"><table border="0" class="variablelist">
 
871
<colgroup>
 
872
<col align="left" valign="top">
 
873
<col>
 
874
</colgroup>
 
875
<tbody>
 
876
<tr>
 
877
<td><p><a name="GDK-ACTION-DEFAULT:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_DEFAULT</code></span></p></td>
 
878
<td>Means nothing, and should not be used.
 
879
</td>
 
880
</tr>
 
881
<tr>
 
882
<td><p><a name="GDK-ACTION-COPY:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_COPY</code></span></p></td>
 
883
<td>Copy the data.
 
884
</td>
 
885
</tr>
 
886
<tr>
 
887
<td><p><a name="GDK-ACTION-MOVE:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_MOVE</code></span></p></td>
 
888
<td>Move the data, i.e. first copy it, then delete
 
889
  it from the source using the DELETE target of the X selection protocol.
 
890
</td>
 
891
</tr>
 
892
<tr>
 
893
<td><p><a name="GDK-ACTION-LINK:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_LINK</code></span></p></td>
 
894
<td>Add a link to the data. Note that this is only
 
895
  useful if source and destination agree on what it means.
 
896
</td>
 
897
</tr>
 
898
<tr>
 
899
<td><p><a name="GDK-ACTION-PRIVATE:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_PRIVATE</code></span></p></td>
 
900
<td>Special action which tells the source that the
 
901
  destination will do something that the source doesn't understand.
 
902
</td>
 
903
</tr>
 
904
<tr>
 
905
<td><p><a name="GDK-ACTION-ASK:CAPS"></a><span class="term"><code class="literal">GDK_ACTION_ASK</code></span></p></td>
 
906
<td>Ask the user what to do with the data.
 
907
</td>
 
908
</tr>
 
909
</tbody>
 
910
</table></div>
 
911
</div>
 
912
<hr>
 
913
<div class="refsect2">
 
914
<a name="gdk-drag-status"></a><h3>gdk_drag_status ()</h3>
 
915
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_status                     (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
916
                                                         <em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> action</code></em>,
 
917
                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
 
918
<p>
 
919
Selects one of the actions offered by the drag source.
 
920
</p>
 
921
<p>
 
922
This function is called by the drag destination in response to
 
923
<a class="link" href="gdk2-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()"><code class="function">gdk_drag_motion()</code></a> called by the drag source.
 
924
</p>
 
925
<div class="variablelist"><table border="0" class="variablelist">
 
926
<colgroup>
 
927
<col align="left" valign="top">
 
928
<col>
 
929
</colgroup>
 
930
<tbody>
 
931
<tr>
 
932
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
933
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>.</td>
 
934
</tr>
 
935
<tr>
 
936
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
 
937
<td>the selected action which will be taken when a drop happens,
 
938
or 0 to indicate that a drop will not be accepted.</td>
 
939
</tr>
 
940
<tr>
 
941
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
942
<td>the timestamp for this operation.</td>
 
943
</tr>
 
944
</tbody>
 
945
</table></div>
 
946
</div>
 
947
<hr>
 
948
<div class="refsect2">
 
949
<a name="gdk-drag-drop-succeeded"></a><h3>gdk_drag_drop_succeeded ()</h3>
 
950
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_drag_drop_succeeded             (<em class="parameter"><code><a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
951
<p>
 
952
Returns whether the dropped data has been successfully 
 
953
transferred. This function is intended to be used while 
 
954
handling a <a class="link" href="gdk2-Events.html#GDK-DROP-FINISHED:CAPS"><code class="literal">GDK_DROP_FINISHED</code></a> event, its return value is
 
955
meaningless at other times.
 
956
</p>
 
957
<div class="variablelist"><table border="0" class="variablelist">
 
958
<colgroup>
 
959
<col align="left" valign="top">
 
960
<col>
 
961
</colgroup>
 
962
<tbody>
 
963
<tr>
 
964
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
965
<td>a <a class="link" href="gdk2-Drag-and-Drop.html#GdkDragContext" title="struct GdkDragContext"><span class="type">GdkDragContext</span></a>
 
966
</td>
 
967
</tr>
 
968
<tr>
 
969
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
970
<td>
 
971
<code class="literal">TRUE</code> if the drop was successful.</td>
 
972
</tr>
 
973
</tbody>
 
974
</table></div>
 
975
<p class="since">Since 2.6</p>
 
976
</div>
 
977
</div>
 
978
</div>
 
979
<div class="footer">
 
980
<hr>
 
981
          Generated by GTK-Doc V1.18</div>
 
982
</body>
 
983
</html>
 
 
b'\\ No newline at end of file'