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

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Drag-and-Drop.html

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

Show diffs side-by-side

added added

removed removed

Lines of Context:
42
42
 
43
43
<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
44
44
<span class="returnvalue">void</span>                <a class="link" href="gdk-Drag-and-Drop.html#gdk-drag-abort" title="gdk_drag_abort ()">gdk_drag_abort</a>                      (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
45
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
45
                                                         <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>);
46
46
<span class="returnvalue">void</span>                <a class="link" href="gdk-Drag-and-Drop.html#gdk-drop-reply" title="gdk_drop_reply ()">gdk_drop_reply</a>                      (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
47
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> ok</code></em>,
48
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
47
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> ok</code></em>,
 
48
                                                         <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>);
49
49
<a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    <a class="link" href="gdk-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
50
<span class="returnvalue">void</span>                <a class="link" href="gdk-Drag-and-Drop.html#gdk-drag-drop" title="gdk_drag_drop ()">gdk_drag_drop</a>                       (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
51
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
51
                                                         <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>);
52
52
<span class="returnvalue">void</span>                <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
53
53
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
54
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
55
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
54
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
56
56
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
57
57
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
59
59
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
60
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><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
62
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
61
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
63
63
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
64
64
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
66
<a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
67
<a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
69
<a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
71
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
72
<a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
66
73
<a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    <a class="link" href="gdk-Drag-and-Drop.html#gdk-drag-begin" title="gdk_drag_begin ()">gdk_drag_begin</a>                      (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
67
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *targets</code></em>);
68
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()">gdk_drag_motion</a>                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *targets</code></em>);
 
75
<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-Drag-and-Drop.html#gdk-drag-motion" title="gdk_drag_motion ()">gdk_drag_motion</a>                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
69
76
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *dest_window</code></em>,
70
77
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> protocol</code></em>,
71
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
72
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
73
80
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> suggested_action</code></em>,
74
81
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> possible_actions</code></em>,
75
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
82
                                                         <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>);
76
83
<span class="returnvalue">void</span>                <a class="link" href="gdk-Drag-and-Drop.html#gdk-drop-finish" title="gdk_drop_finish ()">gdk_drop_finish</a>                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
77
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> success</code></em>,
78
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
84
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> success</code></em>,
 
85
                                                         <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>);
79
86
<a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     <a class="link" href="gdk-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="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="type">GdkNativeWindow</span></a> xid</code></em>,
80
87
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);
81
88
<a class="link" href="gdk-Event-Structures.html#GdkNativeWindow" title="GdkNativeWindow"><span class="returnvalue">GdkNativeWindow</span></a>     <a class="link" href="gdk-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>,
87
94
enum                <a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction">GdkDragAction</a>;
88
95
<span class="returnvalue">void</span>                <a class="link" href="gdk-Drag-and-Drop.html#gdk-drag-status" title="gdk_drag_status ()">gdk_drag_status</a>                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
89
96
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> action</code></em>,
90
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
91
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
 
97
                                                         <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>);
 
98
<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-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);
92
99
</pre>
93
100
</div>
94
101
<div class="refsect1" title="Description">
101
108
<p>
102
109
GTK+ provides a higher level abstraction based on top of these functions,
103
110
and so they are not normally needed in GTK+ applications.
104
 
See the <a href="/usr/share/gtk-doc/html/gtk/gtk-Drag-and-Drop.html">Drag and Drop</a> section of
 
111
See the <a href="http://library.gnome.org/devel/gtk/unstable/gtk-Drag-and-Drop.html">Drag and Drop</a> section of
105
112
the GTK+ documentation for more information.
106
113
</p>
107
114
</div>
133
140
<div class="refsect2" title="gdk_drag_abort ()">
134
141
<a name="gdk-drag-abort"></a><h3>gdk_drag_abort ()</h3>
135
142
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_abort                      (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
136
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
143
                                                         <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>
137
144
<p>
138
145
Aborts a drag without dropping. 
139
146
</p>
160
167
<div class="refsect2" title="gdk_drop_reply ()">
161
168
<a name="gdk-drop-reply"></a><h3>gdk_drop_reply ()</h3>
162
169
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drop_reply                      (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
163
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> ok</code></em>,
164
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
170
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> ok</code></em>,
 
171
                                                         <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>
165
172
<p>
166
173
Accepts or rejects a drop. 
167
174
</p>
180
187
<tr>
181
188
<td><p><span class="term"><em class="parameter"><code>ok</code></em> :</span></p></td>
182
189
<td>
183
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drop is accepted.
 
190
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drop is accepted.
184
191
</td>
185
192
</tr>
186
193
<tr>
211
218
<div class="refsect2" title="gdk_drag_drop ()">
212
219
<a name="gdk-drag-drop"></a><h3>gdk_drag_drop ()</h3>
213
220
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_drop                       (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
214
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
221
                                                         <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>
215
222
<p>
216
223
Drops on the current destination.
217
224
</p>
239
246
<a name="gdk-drag-find-window"></a><h3>gdk_drag_find_window ()</h3>
240
247
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_find_window                (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
241
248
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
242
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
243
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
249
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
250
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
244
251
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
245
252
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
246
253
<p>
294
301
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_find_window_for_screen     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
295
302
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *drag_window</code></em>,
296
303
                                                         <em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
297
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
298
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
304
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
305
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
299
306
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> **dest_window</code></em>,
300
307
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> *protocol</code></em>);</pre>
301
308
<p>
355
362
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_context_ref                (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
356
363
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
357
364
<h3 class="title">Warning</h3>
358
 
<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 <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.</p>
 
365
<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 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.</p>
359
366
</div>
360
367
<p>
361
 
Deprecated function; use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.
 
368
Deprecated function; use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> instead.
362
369
</p>
363
370
<div class="variablelist"><table border="0">
364
371
<col align="left" valign="top">
370
377
</table></div>
371
378
</div>
372
379
<hr>
 
380
<div class="refsect2" title="gdk_drag_context_get_actions ()">
 
381
<a name="gdk-drag-context-get-actions"></a><h3>gdk_drag_context_get_actions ()</h3>
 
382
<pre class="programlisting"><a class="link" href="gdk-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="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
383
<p>
 
384
Determines the bitmask of actions proposed by the source if
 
385
<code class="function">gdk_drag_context_suggested_action()</code> returns GDK_ACTION_ASK.
 
386
</p>
 
387
<div class="variablelist"><table border="0">
 
388
<col align="left" valign="top">
 
389
<tbody>
 
390
<tr>
 
391
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
392
<td>a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a>
 
393
</td>
 
394
</tr>
 
395
<tr>
 
396
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
397
<td> the <a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> flags
 
398
 
 
399
</td>
 
400
</tr>
 
401
</tbody>
 
402
</table></div>
 
403
<p class="since">Since 2.22</p>
 
404
</div>
 
405
<hr>
 
406
<div class="refsect2" title="gdk_drag_context_get_selected_action ()">
 
407
<a name="gdk-drag-context-get-selected-action"></a><h3>gdk_drag_context_get_selected_action ()</h3>
 
408
<pre class="programlisting"><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       gdk_drag_context_get_selected_action
 
409
                                                        (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
410
<p>
 
411
Determines the action chosen by the drag destination.
 
412
</p>
 
413
<div class="variablelist"><table border="0">
 
414
<col align="left" valign="top">
 
415
<tbody>
 
416
<tr>
 
417
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
418
<td>a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a>
 
419
</td>
 
420
</tr>
 
421
<tr>
 
422
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
423
<td> a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> value
 
424
 
 
425
</td>
 
426
</tr>
 
427
</tbody>
 
428
</table></div>
 
429
<p class="since">Since 2.22</p>
 
430
</div>
 
431
<hr>
 
432
<div class="refsect2" title="gdk_drag_context_get_suggested_action ()">
 
433
<a name="gdk-drag-context-get-suggested-action"></a><h3>gdk_drag_context_get_suggested_action ()</h3>
 
434
<pre class="programlisting"><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="returnvalue">GdkDragAction</span></a>       gdk_drag_context_get_suggested_action
 
435
                                                        (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
436
<p>
 
437
Determines the suggested drag action of the context.
 
438
</p>
 
439
<div class="variablelist"><table border="0">
 
440
<col align="left" valign="top">
 
441
<tbody>
 
442
<tr>
 
443
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
444
<td>a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a>
 
445
</td>
 
446
</tr>
 
447
<tr>
 
448
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
449
<td> a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> value
 
450
 
 
451
</td>
 
452
</tr>
 
453
</tbody>
 
454
</table></div>
 
455
<p class="since">Since 2.22</p>
 
456
</div>
 
457
<hr>
 
458
<div class="refsect2" title="gdk_drag_context_list_targets ()">
 
459
<a name="gdk-drag-context-list-targets"></a><h3>gdk_drag_context_list_targets ()</h3>
 
460
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gdk_drag_context_list_targets       (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
461
<p>
 
462
Retrieves the list of targets of the context.
 
463
</p>
 
464
<div class="variablelist"><table border="0">
 
465
<col align="left" valign="top">
 
466
<tbody>
 
467
<tr>
 
468
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
469
<td>a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a>
 
470
</td>
 
471
</tr>
 
472
<tr>
 
473
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
474
<td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of targets
 
475
 
 
476
</td>
 
477
</tr>
 
478
</tbody>
 
479
</table></div>
 
480
<p class="since">Since 2.22</p>
 
481
</div>
 
482
<hr>
 
483
<div class="refsect2" title="gdk_drag_context_get_source_window ()">
 
484
<a name="gdk-drag-context-get-source-window"></a><h3>gdk_drag_context_get_source_window ()</h3>
 
485
<pre class="programlisting"><a class="link" href="gdk-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_drag_context_get_source_window  (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
486
<p>
 
487
Returns the <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> where the DND operation started.
 
488
</p>
 
489
<div class="variablelist"><table border="0">
 
490
<col align="left" valign="top">
 
491
<tbody>
 
492
<tr>
 
493
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
494
<td>a <a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a>
 
495
</td>
 
496
</tr>
 
497
<tr>
 
498
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
499
<td> a <a class="link" href="gdk-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>
 
500
</td>
 
501
</tr>
 
502
</tbody>
 
503
</table></div>
 
504
<p class="since">Since 2.22</p>
 
505
</div>
 
506
<hr>
373
507
<div class="refsect2" title="gdk_drag_begin ()">
374
508
<a name="gdk-drag-begin"></a><h3>gdk_drag_begin ()</h3>
375
509
<pre class="programlisting"><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="returnvalue">GdkDragContext</span></a> *    gdk_drag_begin                      (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
376
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *targets</code></em>);</pre>
 
510
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *targets</code></em>);</pre>
377
511
<p>
378
512
Starts a drag and creates a new drag context for it.
379
513
</p>
404
538
<hr>
405
539
<div class="refsect2" title="gdk_drag_motion ()">
406
540
<a name="gdk-drag-motion"></a><h3>gdk_drag_motion ()</h3>
407
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_drag_motion                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
 
541
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_drag_motion                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
408
542
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *dest_window</code></em>,
409
543
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragProtocol" title="enum GdkDragProtocol"><span class="type">GdkDragProtocol</span></a> protocol</code></em>,
410
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
411
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
 
544
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x_root</code></em>,
 
545
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y_root</code></em>,
412
546
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> suggested_action</code></em>,
413
547
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> possible_actions</code></em>,
414
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
548
                                                         <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>
415
549
<p>
416
550
Updates the drag context when the pointer moves or the 
417
551
set of actions changes.
475
609
<div class="refsect2" title="gdk_drop_finish ()">
476
610
<a name="gdk-drop-finish"></a><h3>gdk_drop_finish ()</h3>
477
611
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drop_finish                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
478
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> success</code></em>,
479
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
612
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> success</code></em>,
 
613
                                                         <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>
480
614
<p>
481
615
Ends the drag operation after a drop.
482
616
</p>
494
628
<tr>
495
629
<td><p><span class="term"><em class="parameter"><code>success</code></em> :</span></p></td>
496
630
<td>
497
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the data was successfully received.
 
631
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the data was successfully received.
498
632
</td>
499
633
</tr>
500
634
<tr>
641
775
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_context_unref              (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
642
776
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
643
777
<h3 class="title">Warning</h3>
644
 
<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 <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.</p>
 
778
<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 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.</p>
645
779
</div>
646
780
<p>
647
 
Deprecated function; use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.
 
781
Deprecated function; use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.
648
782
</p>
649
783
<div class="variablelist"><table border="0">
650
784
<col align="left" valign="top">
684
818
<div class="variablelist"><table border="0">
685
819
<col align="left" valign="top">
686
820
<tbody><tr>
687
 
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> <em class="structfield"><code><a name="GdkDragContext.parent-instance"></a>parent_instance</code></em>;</span></p></td>
 
821
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> <em class="structfield"><code><a name="GdkDragContext.parent-instance"></a>parent_instance</code></em>;</span></p></td>
688
822
<td>the parent instance
689
823
</td>
690
824
</tr></tbody>
751
885
<a name="gdk-drag-status"></a><h3>gdk_drag_status ()</h3>
752
886
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_drag_status                     (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>,
753
887
                                                         <em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragAction" title="enum GdkDragAction"><span class="type">GdkDragAction</span></a> action</code></em>,
754
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
888
                                                         <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>
755
889
<p>
756
890
Selects one of the actions offered by the drag source.
757
891
</p>
784
918
<hr>
785
919
<div class="refsect2" title="gdk_drag_drop_succeeded ()">
786
920
<a name="gdk-drag-drop-succeeded"></a><h3>gdk_drag_drop_succeeded ()</h3>
787
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_drag_drop_succeeded             (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
 
921
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_drag_drop_succeeded             (<em class="parameter"><code><a class="link" href="gdk-Drag-and-Drop.html#GdkDragContext" title="GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
788
922
<p>
789
923
Returns whether the dropped data has been successfully 
790
924
transferred. This function is intended to be used while 
801
935
</tr>
802
936
<tr>
803
937
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
804
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drop was successful.
 
938
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drop was successful.
805
939
 
806
940
</td>
807
941
</tr>