← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/gtk-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=US-ASCII">
 
5
<title>Drag and Drop</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
 
8
<link rel="up" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
9
<link rel="prev" href="gtk-Clipboards.html" title="Clipboards">
 
10
<link rel="next" href="GtkIconTheme.html" title="GtkIconTheme">
 
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
<link rel="part" href="gtk.html" title="Part&#160;I.&#160;GTK+ Overview">
 
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
15
<link rel="part" href="gtkobjects.html" title="Part&#160;III.&#160;GTK+ Widgets and Objects">
 
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
 
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
 
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
 
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
 
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
 
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
 
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
 
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
 
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
 
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
 
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
 
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
 
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
 
30
<link rel="chapter" href="Printing.html" title="Printing">
 
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
 
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
 
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
 
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
 
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
 
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
 
37
<link rel="part" href="migrating.html" title="Part&#160;IV.&#160;Migrating from Previous Versions of GTK+">
 
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
 
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
 
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
 
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
 
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
 
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
 
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
 
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
 
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
 
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
 
48
<link rel="part" href="pt05.html" title="Part&#160;V.&#160;GTK+ Tools">
 
49
<link rel="glossary" href="glossary.html" title="Glossary">
 
50
<link rel="index" href="ix01.html" title="Index">
 
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
 
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
 
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
 
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
 
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
 
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
 
57
</head>
 
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
60
<tr valign="middle">
 
61
<td><a accesskey="p" href="gtk-Clipboards.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
62
<td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
64
<th width="100%" align="center">GTK+ Reference Manual</th>
 
65
<td><a accesskey="n" href="GtkIconTheme.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
66
</tr>
 
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2673209" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id2674536" class="shortcut">Description</a></nobr></td></tr>
 
70
</table>
 
71
<div class="refentry" lang="en">
 
72
<a name="gtk-Drag-and-Drop"></a><div class="titlepage"></div>
 
73
<div class="refnamediv"><table width="100%"><tr>
 
74
<td valign="top">
 
75
<h2>
 
76
<a name="id2673209"></a><span class="refentrytitle">Drag and Drop</span>
 
77
</h2>
 
78
<p>Drag and Drop &#8212; Functions for controlling drag and drop handling</p>
 
79
</td>
 
80
<td valign="top" align="right"></td>
 
81
</tr></table></div>
 
82
<div class="refsynopsisdiv">
 
83
<h2>Synopsis</h2>
 
84
<pre class="synopsis">
 
85
 
 
86
#include &lt;gtk/gtk.h&gt;
 
87
 
 
88
 
 
89
enum                <a href="gtk-Drag-and-Drop.html#GtkDestDefaults">GtkDestDefaults</a>;
 
90
enum                <a href="gtk-Drag-and-Drop.html#GtkTargetFlags">GtkTargetFlags</a>;
 
91
 
 
92
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set">gtk_drag_dest_set</a>                   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
93
                                                         <a href="gtk-Drag-and-Drop.html#GtkDestDefaults">GtkDestDefaults</a> flags,
 
94
                                                         const <a href="gtk-Selections.html#GtkTargetEntry">GtkTargetEntry</a> *targets,
 
95
                                                         gint n_targets,
 
96
                                                         <a
 
97
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
98
>GdkDragAction</a> actions);
 
99
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-proxy">gtk_drag_dest_set_proxy</a>             (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
100
                                                         <a
 
101
href="../gdk/gdk-Windows.html#GdkWindow"
 
102
>GdkWindow</a> *proxy_window,
 
103
                                                         <a
 
104
href="../gdk/gdk-Drag-and-Drop.html#GdkDragProtocol"
 
105
>GdkDragProtocol</a> protocol,
 
106
                                                         gboolean use_coordinates);
 
107
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-unset">gtk_drag_dest_unset</a>                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
108
<a
 
109
href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"
 
110
>GdkAtom</a>             <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-find-target">gtk_drag_dest_find_target</a>           (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
111
                                                         <a
 
112
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
113
>GdkDragContext</a> *context,
 
114
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);
 
115
<a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-get-target-list">gtk_drag_dest_get_target_list</a>       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
116
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-target-list">gtk_drag_dest_set_target_list</a>       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
117
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);
 
118
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-add-text-targets">gtk_drag_dest_add_text_targets</a>      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
119
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-add-image-targets">gtk_drag_dest_add_image_targets</a>     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
120
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-add-uri-targets">gtk_drag_dest_add_uri_targets</a>       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
121
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-track-motion">gtk_drag_dest_set_track_motion</a>      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
122
                                                         gboolean track_motion);
 
123
gboolean            <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-get-track-motion">gtk_drag_dest_get_track_motion</a>      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
124
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-finish">gtk_drag_finish</a>                     (<a
 
125
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
126
>GdkDragContext</a> *context,
 
127
                                                         gboolean success,
 
128
                                                         gboolean del,
 
129
                                                         guint32 time_);
 
130
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-get-data">gtk_drag_get_data</a>                   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
131
                                                         <a
 
132
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
133
>GdkDragContext</a> *context,
 
134
                                                         <a
 
135
href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"
 
136
>GdkAtom</a> target,
 
137
                                                         guint32 time_);
 
138
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="gtk-Drag-and-Drop.html#gtk-drag-get-source-widget">gtk_drag_get_source_widget</a>          (<a
 
139
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
140
>GdkDragContext</a> *context);
 
141
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-highlight">gtk_drag_highlight</a>                  (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
142
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-unhighlight">gtk_drag_unhighlight</a>                (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
143
 
 
144
<a
 
145
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
146
>GdkDragContext</a>*     <a href="gtk-Drag-and-Drop.html#gtk-drag-begin">gtk_drag_begin</a>                      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
147
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *targets,
 
148
                                                         <a
 
149
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
150
>GdkDragAction</a> actions,
 
151
                                                         gint button,
 
152
                                                         <a
 
153
href="../gdk/gdk-Event-Structures.html#GdkEvent"
 
154
>GdkEvent</a> *event);
 
155
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-widget">gtk_drag_set_icon_widget</a>            (<a
 
156
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
157
>GdkDragContext</a> *context,
 
158
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
159
                                                         gint hot_x,
 
160
                                                         gint hot_y);
 
161
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-pixmap">gtk_drag_set_icon_pixmap</a>            (<a
 
162
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
163
>GdkDragContext</a> *context,
 
164
                                                         <a
 
165
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
166
>GdkColormap</a> *colormap,
 
167
                                                         <a
 
168
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
169
>GdkPixmap</a> *pixmap,
 
170
                                                         <a
 
171
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
172
>GdkBitmap</a> *mask,
 
173
                                                         gint hot_x,
 
174
                                                         gint hot_y);
 
175
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-pixbuf">gtk_drag_set_icon_pixbuf</a>            (<a
 
176
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
177
>GdkDragContext</a> *context,
 
178
                                                         <a
 
179
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
180
>GdkPixbuf</a> *pixbuf,
 
181
                                                         gint hot_x,
 
182
                                                         gint hot_y);
 
183
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-stock">gtk_drag_set_icon_stock</a>             (<a
 
184
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
185
>GdkDragContext</a> *context,
 
186
                                                         const gchar *stock_id,
 
187
                                                         gint hot_x,
 
188
                                                         gint hot_y);
 
189
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-name">gtk_drag_set_icon_name</a>              (<a
 
190
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
191
>GdkDragContext</a> *context,
 
192
                                                         const gchar *icon_name,
 
193
                                                         gint hot_x,
 
194
                                                         gint hot_y);
 
195
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-default">gtk_drag_set_icon_default</a>           (<a
 
196
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
197
>GdkDragContext</a> *context);
 
198
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-set-default-icon">gtk_drag_set_default_icon</a>           (<a
 
199
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
200
>GdkColormap</a> *colormap,
 
201
                                                         <a
 
202
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
203
>GdkPixmap</a> *pixmap,
 
204
                                                         <a
 
205
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
206
>GdkBitmap</a> *mask,
 
207
                                                         gint hot_x,
 
208
                                                         gint hot_y);
 
209
gboolean            <a href="gtk-Drag-and-Drop.html#gtk-drag-check-threshold">gtk_drag_check_threshold</a>            (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
210
                                                         gint start_x,
 
211
                                                         gint start_y,
 
212
                                                         gint current_x,
 
213
                                                         gint current_y);
 
214
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set">gtk_drag_source_set</a>                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
215
                                                         <a
 
216
href="../gdk/gdk-Windows.html#GdkModifierType"
 
217
>GdkModifierType</a> start_button_mask,
 
218
                                                         const <a href="gtk-Selections.html#GtkTargetEntry">GtkTargetEntry</a> *targets,
 
219
                                                         gint n_targets,
 
220
                                                         <a
 
221
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
222
>GdkDragAction</a> actions);
 
223
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-icon">gtk_drag_source_set_icon</a>            (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
224
                                                         <a
 
225
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
226
>GdkColormap</a> *colormap,
 
227
                                                         <a
 
228
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
229
>GdkPixmap</a> *pixmap,
 
230
                                                         <a
 
231
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
232
>GdkBitmap</a> *mask);
 
233
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-icon-pixbuf">gtk_drag_source_set_icon_pixbuf</a>     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
234
                                                         <a
 
235
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
236
>GdkPixbuf</a> *pixbuf);
 
237
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-icon-stock">gtk_drag_source_set_icon_stock</a>      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
238
                                                         const gchar *stock_id);
 
239
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-icon-name">gtk_drag_source_set_icon_name</a>       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
240
                                                         const gchar *icon_name);
 
241
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-unset">gtk_drag_source_unset</a>               (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
242
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-target-list">gtk_drag_source_set_target_list</a>     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
243
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);
 
244
<a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      <a href="gtk-Drag-and-Drop.html#gtk-drag-source-get-target-list">gtk_drag_source_get_target_list</a>     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
245
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-add-text-targets">gtk_drag_source_add_text_targets</a>    (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
246
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-add-image-targets">gtk_drag_source_add_image_targets</a>   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
247
void                <a href="gtk-Drag-and-Drop.html#gtk-drag-source-add-uri-targets">gtk_drag_source_add_uri_targets</a>     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
 
248
</pre>
 
249
</div>
 
250
<div class="refsect1" lang="en">
 
251
<a name="id2674536"></a><h2>Description</h2>
 
252
<p>
 
253
GTK+ has a rich set of functions for doing inter-process
 
254
communication via the drag-and-drop metaphor. GTK+
 
255
can do drag-and-drop (DND) via multiple protocols.
 
256
The currently supported protocols are the Xdnd and
 
257
Motif protocols.
 
258
 
 
259
As well as the functions listed here, applications
 
260
may need to use some facilities provided for
 
261
<a href="gtk-Selections.html" title="Selections">Selections</a>.
 
262
Also, the Drag and Drop API makes use of signals
 
263
in the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> class.
 
264
</p>
 
265
</div>
 
266
<div class="refsect1" lang="en">
 
267
<a name="id2674573"></a><h2>Details</h2>
 
268
<div class="refsect2" lang="en">
 
269
<a name="id2674583"></a><h3>
 
270
<a name="GtkDestDefaults"></a>enum GtkDestDefaults</h3>
 
271
<a class="indexterm" name="id2674596"></a><pre class="programlisting">typedef enum {
 
272
  GTK_DEST_DEFAULT_MOTION     = 1 &lt;&lt; 0, /* respond to "drag_motion" */
 
273
  GTK_DEST_DEFAULT_HIGHLIGHT  = 1 &lt;&lt; 1, /* auto-highlight */
 
274
  GTK_DEST_DEFAULT_DROP       = 1 &lt;&lt; 2, /* respond to "drag_drop" */
 
275
  GTK_DEST_DEFAULT_ALL        = 0x07
 
276
} GtkDestDefaults;
 
277
</pre>
 
278
<p>
 
279
The <a href="gtk-Drag-and-Drop.html#GtkDestDefaults"><span class="type">GtkDestDefaults</span></a> enumeration specifies the various
 
280
types of action that will be taken on behalf
 
281
of the user for a drag destination site.
 
282
</p>
 
283
<div class="variablelist"><table border="0">
 
284
<col align="left" valign="top">
 
285
<tbody>
 
286
<tr>
 
287
<td><span class="term"><a name="GTK-DEST-DEFAULT-MOTION:CAPS"></a><code class="literal">GTK_DEST_DEFAULT_MOTION</code></span></td>
 
288
<td>
 
289
   If set for a widget, GTK+, during a drag over this
 
290
   widget will check if the drag matches this widget's
 
291
   list of possible targets and actions.
 
292
   GTK+ will then call <a
 
293
href="../gdk/gdk-Drag-and-Drop.html#gdk-drag-status"
 
294
><code class="function">gdk_drag_status()</code></a> as appropriate.
 
295
</td>
 
296
</tr>
 
297
<tr>
 
298
<td><span class="term"><a name="GTK-DEST-DEFAULT-HIGHLIGHT:CAPS"></a><code class="literal">GTK_DEST_DEFAULT_HIGHLIGHT</code></span></td>
 
299
<td>
 
300
   If set for a widget, GTK+ will draw a highlight on
 
301
   this widget as long as a drag is over this widget
 
302
   and the widget drag format and action are acceptable.
 
303
</td>
 
304
</tr>
 
305
<tr>
 
306
<td><span class="term"><a name="GTK-DEST-DEFAULT-DROP:CAPS"></a><code class="literal">GTK_DEST_DEFAULT_DROP</code></span></td>
 
307
<td>
 
308
   If set for a widget, when a drop occurs, GTK+ will
 
309
   will check if the drag matches this widget's
 
310
   list of possible targets and actions. If so, 
 
311
   GTK+ will call <a href="gtk-Drag-and-Drop.html#gtk-drag-get-data"><code class="function">gtk_drag_get_data()</code></a> on behalf 
 
312
   of the widget. Whether or not the drop is successful,
 
313
   GTK+ will call <a href="gtk-Drag-and-Drop.html#gtk-drag-finish"><code class="function">gtk_drag_finish()</code></a>. If the action
 
314
   was a move, then if the drag was successful, then
 
315
   <code class="literal">TRUE</code> will be passed for the <em class="parameter"><code>delete</code></em> parameter
 
316
   to <a href="gtk-Drag-and-Drop.html#gtk-drag-finish"><code class="function">gtk_drag_finish()</code></a>.
 
317
</td>
 
318
</tr>
 
319
<tr>
 
320
<td><span class="term"><a name="GTK-DEST-DEFAULT-ALL:CAPS"></a><code class="literal">GTK_DEST_DEFAULT_ALL</code></span></td>
 
321
<td>
 
322
   If set, specifies that all default actions should
 
323
   be taken.
 
324
 
 
325
</td>
 
326
</tr>
 
327
</tbody>
 
328
</table></div>
 
329
</div>
 
330
<hr>
 
331
<div class="refsect2" lang="en">
 
332
<a name="id2674794"></a><h3>
 
333
<a name="GtkTargetFlags"></a>enum GtkTargetFlags</h3>
 
334
<a class="indexterm" name="id2674806"></a><pre class="programlisting">typedef enum {
 
335
  GTK_TARGET_SAME_APP = 1 &lt;&lt; 0,    /*&lt; nick=same-app &gt;*/
 
336
  GTK_TARGET_SAME_WIDGET = 1 &lt;&lt; 1  /*&lt; nick=same-widget &gt;*/
 
337
} GtkTargetFlags;
 
338
</pre>
 
339
<p>
 
340
The <a href="gtk-Drag-and-Drop.html#GtkTargetFlags"><span class="type">GtkTargetFlags</span></a> enumeration is used to specify
 
341
constraints on an entry in a <span class="type">GtkTargetTable</span>. 
 
342
</p>
 
343
<div class="variablelist"><table border="0">
 
344
<col align="left" valign="top">
 
345
<tbody>
 
346
<tr>
 
347
<td><span class="term"><a name="GTK-TARGET-SAME-APP:CAPS"></a><code class="literal">GTK_TARGET_SAME_APP</code></span></td>
 
348
<td>
 
349
   If this is set, the target will only be selected
 
350
   for drags within a single application.
 
351
</td>
 
352
</tr>
 
353
<tr>
 
354
<td><span class="term"><a name="GTK-TARGET-SAME-WIDGET:CAPS"></a><code class="literal">GTK_TARGET_SAME_WIDGET</code></span></td>
 
355
<td>
 
356
   If this is set, the target will only be selected
 
357
   for drags within a single widget.
 
358
 
 
359
</td>
 
360
</tr>
 
361
</tbody>
 
362
</table></div>
 
363
</div>
 
364
<hr>
 
365
<div class="refsect2" lang="en">
 
366
<a name="id2674896"></a><h3>
 
367
<a name="gtk-drag-dest-set"></a>gtk_drag_dest_set ()</h3>
 
368
<a class="indexterm" name="id2674909"></a><pre class="programlisting">void                gtk_drag_dest_set                   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
369
                                                         <a href="gtk-Drag-and-Drop.html#GtkDestDefaults">GtkDestDefaults</a> flags,
 
370
                                                         const <a href="gtk-Selections.html#GtkTargetEntry">GtkTargetEntry</a> *targets,
 
371
                                                         gint n_targets,
 
372
                                                         <a
 
373
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
374
>GdkDragAction</a> actions);</pre>
 
375
<p>
 
376
Sets a widget as a potential drop destination.
 
377
</p>
 
378
<div class="variablelist"><table border="0">
 
379
<col align="left" valign="top">
 
380
<tbody>
 
381
<tr>
 
382
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
383
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
384
</td>
 
385
</tr>
 
386
<tr>
 
387
<td><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></td>
 
388
<td>the flags that specify what actions GTK+ should take
 
389
 on behalf of a widget for drops onto that widget. The <em class="parameter"><code>targets</code></em>
 
390
 and <em class="parameter"><code>actions</code></em> fields only are used if <a href="gtk-Drag-and-Drop.html#GTK-DEST-DEFAULT-MOTION:CAPS"><code class="literal">GTK_DEST_DEFAULT_MOTION</code></a>
 
391
 or <a href="gtk-Drag-and-Drop.html#GTK-DEST-DEFAULT-DROP:CAPS"><code class="literal">GTK_DEST_DEFAULT_DROP</code></a> are given.
 
392
</td>
 
393
</tr>
 
394
<tr>
 
395
<td><span class="term"><em class="parameter"><code>targets</code></em>&#160;:</span></td>
 
396
<td>a pointer to an array of <a href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>s indicating
 
397
 the drop types that this widget will accept.
 
398
</td>
 
399
</tr>
 
400
<tr>
 
401
<td><span class="term"><em class="parameter"><code>n_targets</code></em>&#160;:</span></td>
 
402
<td>the number of entries in <em class="parameter"><code>targets</code></em>.
 
403
</td>
 
404
</tr>
 
405
<tr>
 
406
<td><span class="term"><em class="parameter"><code>actions</code></em>&#160;:</span></td>
 
407
<td>a bitmask of possible actions for a drop onto this
 
408
 widget.
 
409
 
 
410
 
 
411
</td>
 
412
</tr>
 
413
</tbody>
 
414
</table></div>
 
415
</div>
 
416
<hr>
 
417
<div class="refsect2" lang="en">
 
418
<a name="id2675106"></a><h3>
 
419
<a name="gtk-drag-dest-set-proxy"></a>gtk_drag_dest_set_proxy ()</h3>
 
420
<a class="indexterm" name="id2675119"></a><pre class="programlisting">void                gtk_drag_dest_set_proxy             (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
421
                                                         <a
 
422
href="../gdk/gdk-Windows.html#GdkWindow"
 
423
>GdkWindow</a> *proxy_window,
 
424
                                                         <a
 
425
href="../gdk/gdk-Drag-and-Drop.html#GdkDragProtocol"
 
426
>GdkDragProtocol</a> protocol,
 
427
                                                         gboolean use_coordinates);</pre>
 
428
<p>
 
429
Sets this widget as a proxy for drops to another window.
 
430
</p>
 
431
<div class="variablelist"><table border="0">
 
432
<col align="left" valign="top">
 
433
<tbody>
 
434
<tr>
 
435
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
436
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
437
</td>
 
438
</tr>
 
439
<tr>
 
440
<td><span class="term"><em class="parameter"><code>proxy_window</code></em>&#160;:</span></td>
 
441
<td>the window to which to forward drag events
 
442
</td>
 
443
</tr>
 
444
<tr>
 
445
<td><span class="term"><em class="parameter"><code>protocol</code></em>&#160;:</span></td>
 
446
<td>the drag protocol which the <em class="parameter"><code>proxy_window</code></em> accepts
 
447
           (You can use <a
 
448
href="../gdk/gdk-Drag-and-Drop.html#gdk-drag-get-protocol"
 
449
><code class="function">gdk_drag_get_protocol()</code></a> to determine this)
 
450
</td>
 
451
</tr>
 
452
<tr>
 
453
<td><span class="term"><em class="parameter"><code>use_coordinates</code></em>&#160;:</span></td>
 
454
<td>If <code class="literal">TRUE</code>, send the same coordinates to the
 
455
                  destination, because it is an embedded 
 
456
                  subwindow.
 
457
 
 
458
 
 
459
</td>
 
460
</tr>
 
461
</tbody>
 
462
</table></div>
 
463
</div>
 
464
<hr>
 
465
<div class="refsect2" lang="en">
 
466
<a name="id2675272"></a><h3>
 
467
<a name="gtk-drag-dest-unset"></a>gtk_drag_dest_unset ()</h3>
 
468
<a class="indexterm" name="id2675285"></a><pre class="programlisting">void                gtk_drag_dest_unset                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
469
<p>
 
470
Clears information about a drop destination set with
 
471
<a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set"><code class="function">gtk_drag_dest_set()</code></a>. The widget will no longer receive
 
472
notification of drags.
 
473
</p>
 
474
<div class="variablelist"><table border="0">
 
475
<col align="left" valign="top">
 
476
<tbody><tr>
 
477
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
478
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
479
 
 
480
 
 
481
</td>
 
482
</tr></tbody>
 
483
</table></div>
 
484
</div>
 
485
<hr>
 
486
<div class="refsect2" lang="en">
 
487
<a name="id2675351"></a><h3>
 
488
<a name="gtk-drag-dest-find-target"></a>gtk_drag_dest_find_target ()</h3>
 
489
<a class="indexterm" name="id2675365"></a><pre class="programlisting"><a
 
490
href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"
 
491
>GdkAtom</a>             gtk_drag_dest_find_target           (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
492
                                                         <a
 
493
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
494
>GdkDragContext</a> *context,
 
495
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);</pre>
 
496
<p>
 
497
Looks for a match between <em class="parameter"><code>context-&gt;targets</code></em> and the
 
498
<em class="parameter"><code>dest_target_list</code></em>, returning the first matching target, otherwise
 
499
returning <a
 
500
href="../gdk/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"
 
501
><code class="literal">GDK_NONE</code></a>. <em class="parameter"><code>dest_target_list</code></em> should usually be the return
 
502
value from <a href="gtk-Drag-and-Drop.html#gtk-drag-dest-get-target-list"><code class="function">gtk_drag_dest_get_target_list()</code></a>, but some widgets may
 
503
have different valid targets for different parts of the widget; in
 
504
that case, they will have to implement a drag_motion handler that
 
505
passes the correct target list to this function.</p>
 
506
<p>
 
507
 
 
508
</p>
 
509
<div class="variablelist"><table border="0">
 
510
<col align="left" valign="top">
 
511
<tbody>
 
512
<tr>
 
513
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
514
<td> drag destination widget
 
515
</td>
 
516
</tr>
 
517
<tr>
 
518
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
519
<td> drag context
 
520
</td>
 
521
</tr>
 
522
<tr>
 
523
<td><span class="term"><em class="parameter"><code>target_list</code></em>&#160;:</span></td>
 
524
<td> list of droppable targets, or <a
 
525
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
526
><code class="literal">NULL</code></a> to use
 
527
   gtk_drag_dest_get_target_list (<em class="parameter"><code>widget</code></em>).
 
528
</td>
 
529
</tr>
 
530
<tr>
 
531
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
532
<td> first target that the source offers and the dest can accept, or <a
 
533
href="../gdk/gdk-Properties-and-Atoms.html#GDK-NONE:CAPS"
 
534
><code class="literal">GDK_NONE</code></a>
 
535
</td>
 
536
</tr>
 
537
</tbody>
 
538
</table></div>
 
539
</div>
 
540
<hr>
 
541
<div class="refsect2" lang="en">
 
542
<a name="id2675543"></a><h3>
 
543
<a name="gtk-drag-dest-get-target-list"></a>gtk_drag_dest_get_target_list ()</h3>
 
544
<a class="indexterm" name="id2675557"></a><pre class="programlisting"><a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      gtk_drag_dest_get_target_list       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
545
<p>
 
546
Returns the list of targets this widget can accept from
 
547
drag-and-drop.</p>
 
548
<p>
 
549
 
 
550
</p>
 
551
<div class="variablelist"><table border="0">
 
552
<col align="left" valign="top">
 
553
<tbody>
 
554
<tr>
 
555
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
556
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
557
</td>
 
558
</tr>
 
559
<tr>
 
560
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
561
<td> the <a href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>, or <a
 
562
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
563
><code class="literal">NULL</code></a> if none
 
564
</td>
 
565
</tr>
 
566
</tbody>
 
567
</table></div>
 
568
</div>
 
569
<hr>
 
570
<div class="refsect2" lang="en">
 
571
<a name="id2675644"></a><h3>
 
572
<a name="gtk-drag-dest-set-target-list"></a>gtk_drag_dest_set_target_list ()</h3>
 
573
<a class="indexterm" name="id2675658"></a><pre class="programlisting">void                gtk_drag_dest_set_target_list       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
574
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);</pre>
 
575
<p>
 
576
Sets the target types that this widget can accept from drag-and-drop.
 
577
The widget must first be made into a drag destination with
 
578
<a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set"><code class="function">gtk_drag_dest_set()</code></a>.</p>
 
579
<p>
 
580
 
 
581
</p>
 
582
<div class="variablelist"><table border="0">
 
583
<col align="left" valign="top">
 
584
<tbody>
 
585
<tr>
 
586
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
587
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
588
</td>
 
589
</tr>
 
590
<tr>
 
591
<td><span class="term"><em class="parameter"><code>target_list</code></em>&#160;:</span></td>
 
592
<td> list of droppable targets, or <a
 
593
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
594
><code class="literal">NULL</code></a> for none
 
595
</td>
 
596
</tr>
 
597
</tbody>
 
598
</table></div>
 
599
</div>
 
600
<hr>
 
601
<div class="refsect2" lang="en">
 
602
<a name="id2675761"></a><h3>
 
603
<a name="gtk-drag-dest-add-text-targets"></a>gtk_drag_dest_add_text_targets ()</h3>
 
604
<a class="indexterm" name="id2675776"></a><pre class="programlisting">void                gtk_drag_dest_add_text_targets      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
605
<p>
 
606
Add the text targets supported by <span class="type">GtkSelection</span> to
 
607
the target list of the drag destination. The targets
 
608
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
609
use <a href="gtk-Selections.html#gtk-target-list-add-text-targets"><code class="function">gtk_target_list_add_text_targets()</code></a> and
 
610
<a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-target-list"><code class="function">gtk_drag_dest_set_target_list()</code></a>.</p>
 
611
<p>
 
612
 
 
613
</p>
 
614
<div class="variablelist"><table border="0">
 
615
<col align="left" valign="top">
 
616
<tbody><tr>
 
617
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
618
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
619
</td>
 
620
</tr></tbody>
 
621
</table></div>
 
622
<p class="since">Since  2.6
 
623
</p>
 
624
</div>
 
625
<hr>
 
626
<div class="refsect2" lang="en">
 
627
<a name="id2675882"></a><h3>
 
628
<a name="gtk-drag-dest-add-image-targets"></a>gtk_drag_dest_add_image_targets ()</h3>
 
629
<a class="indexterm" name="id2675897"></a><pre class="programlisting">void                gtk_drag_dest_add_image_targets     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
630
<p>
 
631
Add the image targets supported by <span class="type">GtkSelection</span> to
 
632
the target list of the drag destination. The targets
 
633
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
634
use <a href="gtk-Selections.html#gtk-target-list-add-image-targets"><code class="function">gtk_target_list_add_image_targets()</code></a> and
 
635
<a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-target-list"><code class="function">gtk_drag_dest_set_target_list()</code></a>.</p>
 
636
<p>
 
637
 
 
638
</p>
 
639
<div class="variablelist"><table border="0">
 
640
<col align="left" valign="top">
 
641
<tbody><tr>
 
642
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
643
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
644
</td>
 
645
</tr></tbody>
 
646
</table></div>
 
647
<p class="since">Since  2.6
 
648
</p>
 
649
</div>
 
650
<hr>
 
651
<div class="refsect2" lang="en">
 
652
<a name="id2676003"></a><h3>
 
653
<a name="gtk-drag-dest-add-uri-targets"></a>gtk_drag_dest_add_uri_targets ()</h3>
 
654
<a class="indexterm" name="id2676019"></a><pre class="programlisting">void                gtk_drag_dest_add_uri_targets       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
655
<p>
 
656
Add the URI targets supported by <span class="type">GtkSelection</span> to
 
657
the target list of the drag destination. The targets
 
658
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
659
use <a href="gtk-Selections.html#gtk-target-list-add-uri-targets"><code class="function">gtk_target_list_add_uri_targets()</code></a> and
 
660
<a href="gtk-Drag-and-Drop.html#gtk-drag-dest-set-target-list"><code class="function">gtk_drag_dest_set_target_list()</code></a>.</p>
 
661
<p>
 
662
 
 
663
</p>
 
664
<div class="variablelist"><table border="0">
 
665
<col align="left" valign="top">
 
666
<tbody><tr>
 
667
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
668
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
669
</td>
 
670
</tr></tbody>
 
671
</table></div>
 
672
<p class="since">Since  2.6
 
673
</p>
 
674
</div>
 
675
<hr>
 
676
<div class="refsect2" lang="en">
 
677
<a name="id2676123"></a><h3>
 
678
<a name="gtk-drag-dest-set-track-motion"></a>gtk_drag_dest_set_track_motion ()</h3>
 
679
<a class="indexterm" name="id2676139"></a><pre class="programlisting">void                gtk_drag_dest_set_track_motion      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
680
                                                         gboolean track_motion);</pre>
 
681
<p>
 
682
Tells the widget to emit ::drag-motion and ::drag-leave
 
683
events regardless of the targets and the <a href="gtk-Drag-and-Drop.html#GTK-DEST-DEFAULT-MOTION:CAPS"><code class="literal">GTK_DEST_DEFAULT_MOTION</code></a>
 
684
flag. 
 
685
</p>
 
686
<p>
 
687
This may be used when a widget wants to do generic
 
688
actions regardless of the targets that the source offers.</p>
 
689
<p>
 
690
 
 
691
</p>
 
692
<div class="variablelist"><table border="0">
 
693
<col align="left" valign="top">
 
694
<tbody>
 
695
<tr>
 
696
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
697
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
698
</td>
 
699
</tr>
 
700
<tr>
 
701
<td><span class="term"><em class="parameter"><code>track_motion</code></em>&#160;:</span></td>
 
702
<td> whether to accept all targets
 
703
</td>
 
704
</tr>
 
705
</tbody>
 
706
</table></div>
 
707
<p class="since">Since  2.10
 
708
</p>
 
709
</div>
 
710
<hr>
 
711
<div class="refsect2" lang="en">
 
712
<a name="id2676244"></a><h3>
 
713
<a name="gtk-drag-dest-get-track-motion"></a>gtk_drag_dest_get_track_motion ()</h3>
 
714
<a class="indexterm" name="id2676260"></a><pre class="programlisting">gboolean            gtk_drag_dest_get_track_motion      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
715
<p>
 
716
Returns whether the widget has been configured to always
 
717
emit ::drag-motion signals.</p>
 
718
<p>
 
719
 
 
720
</p>
 
721
<div class="variablelist"><table border="0">
 
722
<col align="left" valign="top">
 
723
<tbody>
 
724
<tr>
 
725
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
726
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag destination
 
727
</td>
 
728
</tr>
 
729
<tr>
 
730
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
731
<td> <code class="literal">TRUE</code> if the widget always emits ::drag-motion events
 
732
 
 
733
</td>
 
734
</tr>
 
735
</tbody>
 
736
</table></div>
 
737
<p class="since">Since  2.10
 
738
</p>
 
739
</div>
 
740
<hr>
 
741
<div class="refsect2" lang="en">
 
742
<a name="id2676347"></a><h3>
 
743
<a name="gtk-drag-finish"></a>gtk_drag_finish ()</h3>
 
744
<a class="indexterm" name="id2676360"></a><pre class="programlisting">void                gtk_drag_finish                     (<a
 
745
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
746
>GdkDragContext</a> *context,
 
747
                                                         gboolean success,
 
748
                                                         gboolean del,
 
749
                                                         guint32 time_);</pre>
 
750
<p>
 
751
Informs the drag source that the drop is finished, and
 
752
that the data of the drag will no longer be required.
 
753
</p>
 
754
<div class="variablelist"><table border="0">
 
755
<col align="left" valign="top">
 
756
<tbody>
 
757
<tr>
 
758
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
759
<td>the drag context.
 
760
</td>
 
761
</tr>
 
762
<tr>
 
763
<td><span class="term"><em class="parameter"><code>success</code></em>&#160;:</span></td>
 
764
<td>a flag indicating whether the drop was successful
 
765
</td>
 
766
</tr>
 
767
<tr>
 
768
<td><span class="term"><em class="parameter"><code>del</code></em>&#160;:</span></td>
 
769
<td>a flag indicating whether the source should delete the
 
770
      original data. (This should be <code class="literal">TRUE</code> for a move)
 
771
</td>
 
772
</tr>
 
773
<tr>
 
774
<td><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></td>
 
775
<td>the timestamp from the "drag_data_drop" signal.
 
776
 
 
777
 
 
778
</td>
 
779
</tr>
 
780
</tbody>
 
781
</table></div>
 
782
</div>
 
783
<hr>
 
784
<div class="refsect2" lang="en">
 
785
<a name="id2676487"></a><h3>
 
786
<a name="gtk-drag-get-data"></a>gtk_drag_get_data ()</h3>
 
787
<a class="indexterm" name="id2676500"></a><pre class="programlisting">void                gtk_drag_get_data                   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
788
                                                         <a
 
789
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
790
>GdkDragContext</a> *context,
 
791
                                                         <a
 
792
href="../gdk/gdk-Properties-and-Atoms.html#GdkAtom"
 
793
>GdkAtom</a> target,
 
794
                                                         guint32 time_);</pre>
 
795
<p>
 
796
Gets the data associated with a drag. When the data
 
797
is received or the retrieval fails, GTK+ will emit a 
 
798
"drag_data_received" signal. Failure of the retrieval
 
799
is indicated by the length field of the <em class="parameter"><code>selection_data</code></em>
 
800
signal parameter being negative. However, when <a href="gtk-Drag-and-Drop.html#gtk-drag-get-data"><code class="function">gtk_drag_get_data()</code></a> 
 
801
is called implicitely because the <a href="gtk-Drag-and-Drop.html#GTK-DEST-DEFAULT-DROP:CAPS"><code class="literal">GTK_DEST_DEFAULT_DROP</code></a> was set, 
 
802
then the widget will not receive notification of failed
 
803
drops.
 
804
</p>
 
805
<div class="variablelist"><table border="0">
 
806
<col align="left" valign="top">
 
807
<tbody>
 
808
<tr>
 
809
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
810
<td>the widget that will receive the "drag_data_received"
 
811
 signal.
 
812
</td>
 
813
</tr>
 
814
<tr>
 
815
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
816
<td>the drag context
 
817
</td>
 
818
</tr>
 
819
<tr>
 
820
<td><span class="term"><em class="parameter"><code>target</code></em>&#160;:</span></td>
 
821
<td>the target (form of the data) to retrieve.
 
822
</td>
 
823
</tr>
 
824
<tr>
 
825
<td><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></td>
 
826
<td>a timestamp for retrieving the data. This will
 
827
       generally be the time received in a "drag_data_motion"
 
828
       or "drag_data_drop" signal.
 
829
 
 
830
 
 
831
</td>
 
832
</tr>
 
833
</tbody>
 
834
</table></div>
 
835
</div>
 
836
<hr>
 
837
<div class="refsect2" lang="en">
 
838
<a name="id2676649"></a><h3>
 
839
<a name="gtk-drag-get-source-widget"></a>gtk_drag_get_source_widget ()</h3>
 
840
<a class="indexterm" name="id2676663"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_drag_get_source_widget          (<a
 
841
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
842
>GdkDragContext</a> *context);</pre>
 
843
<p>
 
844
Determines the source widget for a drag.
 
845
</p>
 
846
<div class="variablelist"><table border="0">
 
847
<col align="left" valign="top">
 
848
<tbody>
 
849
<tr>
 
850
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
851
<td>a (destination side) drag context.
 
852
</td>
 
853
</tr>
 
854
<tr>
 
855
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
856
<td>if the drag is occurring within a single application,
 
857
          a pointer to the source widget. Otherwise, <a
 
858
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
859
><code class="literal">NULL</code></a>.
 
860
 
 
861
 
 
862
</td>
 
863
</tr>
 
864
</tbody>
 
865
</table></div>
 
866
</div>
 
867
<hr>
 
868
<div class="refsect2" lang="en">
 
869
<a name="id2676732"></a><h3>
 
870
<a name="gtk-drag-highlight"></a>gtk_drag_highlight ()</h3>
 
871
<a class="indexterm" name="id2676746"></a><pre class="programlisting">void                gtk_drag_highlight                  (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
872
<p>
 
873
Draws a highlight around a widget. This will attach
 
874
handlers to  "expose_event" and "draw", so the highlight
 
875
will continue to be displayed until <a href="gtk-Drag-and-Drop.html#gtk-drag-unhighlight"><code class="function">gtk_drag_unhighlight()</code></a>
 
876
is called.
 
877
</p>
 
878
<div class="variablelist"><table border="0">
 
879
<col align="left" valign="top">
 
880
<tbody><tr>
 
881
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
882
<td>a widget to highlight
 
883
 
 
884
 
 
885
</td>
 
886
</tr></tbody>
 
887
</table></div>
 
888
</div>
 
889
<hr>
 
890
<div class="refsect2" lang="en">
 
891
<a name="id2676806"></a><h3>
 
892
<a name="gtk-drag-unhighlight"></a>gtk_drag_unhighlight ()</h3>
 
893
<a class="indexterm" name="id2676819"></a><pre class="programlisting">void                gtk_drag_unhighlight                (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
894
<p>
 
895
Removes a highlight set by <a href="gtk-Drag-and-Drop.html#gtk-drag-highlight"><code class="function">gtk_drag_highlight()</code></a> from
 
896
a widget.
 
897
</p>
 
898
<div class="variablelist"><table border="0">
 
899
<col align="left" valign="top">
 
900
<tbody><tr>
 
901
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
902
<td>a widget to remove the highlight from.
 
903
 
 
904
 
 
905
</td>
 
906
</tr></tbody>
 
907
</table></div>
 
908
</div>
 
909
<hr>
 
910
<div class="refsect2" lang="en">
 
911
<a name="id2676878"></a><h3>
 
912
<a name="gtk-drag-begin"></a>gtk_drag_begin ()</h3>
 
913
<a class="indexterm" name="id2676891"></a><pre class="programlisting"><a
 
914
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
915
>GdkDragContext</a>*     gtk_drag_begin                      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
916
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *targets,
 
917
                                                         <a
 
918
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
919
>GdkDragAction</a> actions,
 
920
                                                         gint button,
 
921
                                                         <a
 
922
href="../gdk/gdk-Event-Structures.html#GdkEvent"
 
923
>GdkEvent</a> *event);</pre>
 
924
<p>
 
925
Initiates a drag on the source side. The function
 
926
only needs to be used when the application is
 
927
starting drags itself, and is not needed when
 
928
<a href="gtk-Drag-and-Drop.html#gtk-drag-source-set"><code class="function">gtk_drag_source_set()</code></a> is used.</p>
 
929
<p>
 
930
 
 
931
</p>
 
932
<div class="variablelist"><table border="0">
 
933
<col align="left" valign="top">
 
934
<tbody>
 
935
<tr>
 
936
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
937
<td> the source widget.
 
938
</td>
 
939
</tr>
 
940
<tr>
 
941
<td><span class="term"><em class="parameter"><code>targets</code></em>&#160;:</span></td>
 
942
<td> The targets (data formats) in which the
 
943
   source can provide the data.
 
944
</td>
 
945
</tr>
 
946
<tr>
 
947
<td><span class="term"><em class="parameter"><code>actions</code></em>&#160;:</span></td>
 
948
<td> A bitmask of the allowed drag actions for this drag.
 
949
</td>
 
950
</tr>
 
951
<tr>
 
952
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
953
<td> The button the user clicked to start the drag.
 
954
</td>
 
955
</tr>
 
956
<tr>
 
957
<td><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></td>
 
958
<td> The event that triggered the start of the drag.
 
959
</td>
 
960
</tr>
 
961
<tr>
 
962
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
963
<td> the context for this drag.
 
964
</td>
 
965
</tr>
 
966
</tbody>
 
967
</table></div>
 
968
</div>
 
969
<hr>
 
970
<div class="refsect2" lang="en">
 
971
<a name="id2677056"></a><h3>
 
972
<a name="gtk-drag-set-icon-widget"></a>gtk_drag_set_icon_widget ()</h3>
 
973
<a class="indexterm" name="id2677069"></a><pre class="programlisting">void                gtk_drag_set_icon_widget            (<a
 
974
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
975
>GdkDragContext</a> *context,
 
976
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
977
                                                         gint hot_x,
 
978
                                                         gint hot_y);</pre>
 
979
<p>
 
980
Changes the icon for a widget to a given widget. GTK+
 
981
will not destroy the icon, so if you don't want
 
982
it to persist, you should connect to the "drag_end" 
 
983
signal and destroy it yourself.</p>
 
984
<p>
 
985
</p>
 
986
<div class="variablelist"><table border="0">
 
987
<col align="left" valign="top">
 
988
<tbody>
 
989
<tr>
 
990
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
991
<td> the context for a drag. (This must be called 
 
992
          with a  context for the source side of a drag)
 
993
</td>
 
994
</tr>
 
995
<tr>
 
996
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
997
<td> a toplevel window to use as an icon.
 
998
</td>
 
999
</tr>
 
1000
<tr>
 
1001
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1002
<td> the X offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1003
</td>
 
1004
</tr>
 
1005
<tr>
 
1006
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1007
<td> the Y offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1008
</td>
 
1009
</tr>
 
1010
</tbody>
 
1011
</table></div>
 
1012
</div>
 
1013
<hr>
 
1014
<div class="refsect2" lang="en">
 
1015
<a name="id2677202"></a><h3>
 
1016
<a name="gtk-drag-set-icon-pixmap"></a>gtk_drag_set_icon_pixmap ()</h3>
 
1017
<a class="indexterm" name="id2677215"></a><pre class="programlisting">void                gtk_drag_set_icon_pixmap            (<a
 
1018
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
1019
>GdkDragContext</a> *context,
 
1020
                                                         <a
 
1021
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
1022
>GdkColormap</a> *colormap,
 
1023
                                                         <a
 
1024
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
1025
>GdkPixmap</a> *pixmap,
 
1026
                                                         <a
 
1027
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
1028
>GdkBitmap</a> *mask,
 
1029
                                                         gint hot_x,
 
1030
                                                         gint hot_y);</pre>
 
1031
<p>
 
1032
Sets <em class="parameter"><code>pixmap</code></em> as the icon for a given drag. GTK+ retains
 
1033
references for the arguments, and will release them when
 
1034
they are no longer needed. In general, <a href="gtk-Drag-and-Drop.html#gtk-drag-set-icon-pixbuf"><code class="function">gtk_drag_set_icon_pixbuf()</code></a>
 
1035
will be more convenient to use.</p>
 
1036
<p>
 
1037
</p>
 
1038
<div class="variablelist"><table border="0">
 
1039
<col align="left" valign="top">
 
1040
<tbody>
 
1041
<tr>
 
1042
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
1043
<td> the context for a drag. (This must be called 
 
1044
           with a  context for the source side of a drag)
 
1045
</td>
 
1046
</tr>
 
1047
<tr>
 
1048
<td><span class="term"><em class="parameter"><code>colormap</code></em>&#160;:</span></td>
 
1049
<td> the colormap of the icon 
 
1050
</td>
 
1051
</tr>
 
1052
<tr>
 
1053
<td><span class="term"><em class="parameter"><code>pixmap</code></em>&#160;:</span></td>
 
1054
<td> the image data for the icon 
 
1055
</td>
 
1056
</tr>
 
1057
<tr>
 
1058
<td><span class="term"><em class="parameter"><code>mask</code></em>&#160;:</span></td>
 
1059
<td> the transparency mask for the icon
 
1060
</td>
 
1061
</tr>
 
1062
<tr>
 
1063
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1064
<td> the X offset within <em class="parameter"><code>pixmap</code></em> of the hotspot.
 
1065
</td>
 
1066
</tr>
 
1067
<tr>
 
1068
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1069
<td> the Y offset within <em class="parameter"><code>pixmap</code></em> of the hotspot.
 
1070
</td>
 
1071
</tr>
 
1072
</tbody>
 
1073
</table></div>
 
1074
</div>
 
1075
<hr>
 
1076
<div class="refsect2" lang="en">
 
1077
<a name="id2677409"></a><h3>
 
1078
<a name="gtk-drag-set-icon-pixbuf"></a>gtk_drag_set_icon_pixbuf ()</h3>
 
1079
<a class="indexterm" name="id2677423"></a><pre class="programlisting">void                gtk_drag_set_icon_pixbuf            (<a
 
1080
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
1081
>GdkDragContext</a> *context,
 
1082
                                                         <a
 
1083
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
1084
>GdkPixbuf</a> *pixbuf,
 
1085
                                                         gint hot_x,
 
1086
                                                         gint hot_y);</pre>
 
1087
<p>
 
1088
Sets <em class="parameter"><code>pixbuf</code></em> as the icon for a given drag.</p>
 
1089
<p>
 
1090
 
 
1091
</p>
 
1092
<div class="variablelist"><table border="0">
 
1093
<col align="left" valign="top">
 
1094
<tbody>
 
1095
<tr>
 
1096
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
1097
<td> the context for a drag. (This must be called 
 
1098
           with a  context for the source side of a drag)
 
1099
</td>
 
1100
</tr>
 
1101
<tr>
 
1102
<td><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></td>
 
1103
<td> the <a
 
1104
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
1105
><span class="type">GdkPixbuf</span></a> to use as the drag icon.
 
1106
</td>
 
1107
</tr>
 
1108
<tr>
 
1109
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1110
<td> the X offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1111
</td>
 
1112
</tr>
 
1113
<tr>
 
1114
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1115
<td> the Y offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1116
</td>
 
1117
</tr>
 
1118
</tbody>
 
1119
</table></div>
 
1120
</div>
 
1121
<hr>
 
1122
<div class="refsect2" lang="en">
 
1123
<a name="id2677567"></a><h3>
 
1124
<a name="gtk-drag-set-icon-stock"></a>gtk_drag_set_icon_stock ()</h3>
 
1125
<a class="indexterm" name="id2677580"></a><pre class="programlisting">void                gtk_drag_set_icon_stock             (<a
 
1126
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
1127
>GdkDragContext</a> *context,
 
1128
                                                         const gchar *stock_id,
 
1129
                                                         gint hot_x,
 
1130
                                                         gint hot_y);</pre>
 
1131
<p>
 
1132
Sets the icon for a given drag from a stock ID.</p>
 
1133
<p>
 
1134
 
 
1135
</p>
 
1136
<div class="variablelist"><table border="0">
 
1137
<col align="left" valign="top">
 
1138
<tbody>
 
1139
<tr>
 
1140
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
1141
<td> the context for a drag. (This must be called 
 
1142
           with a  context for the source side of a drag)
 
1143
</td>
 
1144
</tr>
 
1145
<tr>
 
1146
<td><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
 
1147
<td> the ID of the stock icon to use for the drag.
 
1148
</td>
 
1149
</tr>
 
1150
<tr>
 
1151
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1152
<td> the X offset within the icon of the hotspot.
 
1153
</td>
 
1154
</tr>
 
1155
<tr>
 
1156
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1157
<td> the Y offset within the icon of the hotspot.
 
1158
</td>
 
1159
</tr>
 
1160
</tbody>
 
1161
</table></div>
 
1162
</div>
 
1163
<hr>
 
1164
<div class="refsect2" lang="en">
 
1165
<a name="id2677700"></a><h3>
 
1166
<a name="gtk-drag-set-icon-name"></a>gtk_drag_set_icon_name ()</h3>
 
1167
<a class="indexterm" name="id2677716"></a><pre class="programlisting">void                gtk_drag_set_icon_name              (<a
 
1168
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
1169
>GdkDragContext</a> *context,
 
1170
                                                         const gchar *icon_name,
 
1171
                                                         gint hot_x,
 
1172
                                                         gint hot_y);</pre>
 
1173
<p>
 
1174
Sets the icon for a given drag from a named themed icon. See
 
1175
the docs for <a href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details. Note that the
 
1176
size of the icon depends on the icon theme (the icon is
 
1177
loaded at the symbolic size <span class="type">GTK_ICON_SIZE_DND</span>), thus 
 
1178
<em class="parameter"><code>hot_x</code></em> and <em class="parameter"><code>hot_y</code></em> have to be used with care.</p>
 
1179
<p>
 
1180
 
 
1181
</p>
 
1182
<div class="variablelist"><table border="0">
 
1183
<col align="left" valign="top">
 
1184
<tbody>
 
1185
<tr>
 
1186
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
1187
<td> the context for a drag. (This must be called 
 
1188
           with a context for the source side of a drag)
 
1189
</td>
 
1190
</tr>
 
1191
<tr>
 
1192
<td><span class="term"><em class="parameter"><code>icon_name</code></em>&#160;:</span></td>
 
1193
<td> name of icon to use
 
1194
</td>
 
1195
</tr>
 
1196
<tr>
 
1197
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1198
<td> the X offset of the hotspot within the icon
 
1199
</td>
 
1200
</tr>
 
1201
<tr>
 
1202
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1203
<td> the Y offset of the hotspot within the icon
 
1204
</td>
 
1205
</tr>
 
1206
</tbody>
 
1207
</table></div>
 
1208
<p class="since">Since  2.8
 
1209
</p>
 
1210
</div>
 
1211
<hr>
 
1212
<div class="refsect2" lang="en">
 
1213
<a name="id2677876"></a><h3>
 
1214
<a name="gtk-drag-set-icon-default"></a>gtk_drag_set_icon_default ()</h3>
 
1215
<a class="indexterm" name="id2677890"></a><pre class="programlisting">void                gtk_drag_set_icon_default           (<a
 
1216
href="../gdk/gdk-Drag-and-Drop.html#GdkDragContext"
 
1217
>GdkDragContext</a> *context);</pre>
 
1218
<p>
 
1219
Sets the icon for a particular drag to the default
 
1220
icon.</p>
 
1221
<p>
 
1222
</p>
 
1223
<div class="variablelist"><table border="0">
 
1224
<col align="left" valign="top">
 
1225
<tbody><tr>
 
1226
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
 
1227
<td> the context for a drag. (This must be called 
 
1228
             with a  context for the source side of a drag)
 
1229
</td>
 
1230
</tr></tbody>
 
1231
</table></div>
 
1232
</div>
 
1233
<hr>
 
1234
<div class="refsect2" lang="en">
 
1235
<a name="id2677942"></a><h3>
 
1236
<a name="gtk-drag-set-default-icon"></a>gtk_drag_set_default_icon ()</h3>
 
1237
<a class="indexterm" name="id2677958"></a><pre class="programlisting">void                gtk_drag_set_default_icon           (<a
 
1238
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
1239
>GdkColormap</a> *colormap,
 
1240
                                                         <a
 
1241
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
1242
>GdkPixmap</a> *pixmap,
 
1243
                                                         <a
 
1244
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
1245
>GdkBitmap</a> *mask,
 
1246
                                                         gint hot_x,
 
1247
                                                         gint hot_y);</pre>
 
1248
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1249
<h3 class="title">Warning</h3>
 
1250
<p><code class="literal">gtk_drag_set_default_icon</code> is deprecated and should not be used in newly-written code.</p>
 
1251
</div>
 
1252
<p>
 
1253
Changes the default drag icon. GTK+ retains references for the
 
1254
arguments, and will release them when they are no longer needed.
 
1255
This function is obsolete. The default icon should now be changed
 
1256
via the stock system by changing the stock pixbuf for <a href="gtk-Stock-Items.html#GTK-STOCK-DND:CAPS"><span class="type">GTK_STOCK_DND</span></a>.</p>
 
1257
<p>
 
1258
 
 
1259
</p>
 
1260
<div class="variablelist"><table border="0">
 
1261
<col align="left" valign="top">
 
1262
<tbody>
 
1263
<tr>
 
1264
<td><span class="term"><em class="parameter"><code>colormap</code></em>&#160;:</span></td>
 
1265
<td> the colormap of the icon
 
1266
</td>
 
1267
</tr>
 
1268
<tr>
 
1269
<td><span class="term"><em class="parameter"><code>pixmap</code></em>&#160;:</span></td>
 
1270
<td> the image data for the icon
 
1271
</td>
 
1272
</tr>
 
1273
<tr>
 
1274
<td><span class="term"><em class="parameter"><code>mask</code></em>&#160;:</span></td>
 
1275
<td> the transparency mask for an image.
 
1276
</td>
 
1277
</tr>
 
1278
<tr>
 
1279
<td><span class="term"><em class="parameter"><code>hot_x</code></em>&#160;:</span></td>
 
1280
<td> The X offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1281
</td>
 
1282
</tr>
 
1283
<tr>
 
1284
<td><span class="term"><em class="parameter"><code>hot_y</code></em>&#160;:</span></td>
 
1285
<td> The Y offset within <em class="parameter"><code>widget</code></em> of the hotspot.
 
1286
</td>
 
1287
</tr>
 
1288
</tbody>
 
1289
</table></div>
 
1290
</div>
 
1291
<hr>
 
1292
<div class="refsect2" lang="en">
 
1293
<a name="id2678134"></a><h3>
 
1294
<a name="gtk-drag-check-threshold"></a>gtk_drag_check_threshold ()</h3>
 
1295
<a class="indexterm" name="id2678147"></a><pre class="programlisting">gboolean            gtk_drag_check_threshold            (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1296
                                                         gint start_x,
 
1297
                                                         gint start_y,
 
1298
                                                         gint current_x,
 
1299
                                                         gint current_y);</pre>
 
1300
<p>
 
1301
Checks to see if a mouse drag starting at (<em class="parameter"><code>start_x</code></em>, <em class="parameter"><code>start_y</code></em>) and ending
 
1302
at (<em class="parameter"><code>current_x</code></em>, <em class="parameter"><code>current_y</code></em>) has passed the GTK+ drag threshold, and thus
 
1303
should trigger the beginning of a drag-and-drop operation.</p>
 
1304
<p>
 
1305
 
 
1306
</p>
 
1307
<div class="variablelist"><table border="0">
 
1308
<col align="left" valign="top">
 
1309
<tbody>
 
1310
<tr>
 
1311
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1312
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1313
</td>
 
1314
</tr>
 
1315
<tr>
 
1316
<td><span class="term"><em class="parameter"><code>start_x</code></em>&#160;:</span></td>
 
1317
<td> X coordinate of start of drag
 
1318
</td>
 
1319
</tr>
 
1320
<tr>
 
1321
<td><span class="term"><em class="parameter"><code>start_y</code></em>&#160;:</span></td>
 
1322
<td> Y coordinate of start of drag
 
1323
</td>
 
1324
</tr>
 
1325
<tr>
 
1326
<td><span class="term"><em class="parameter"><code>current_x</code></em>&#160;:</span></td>
 
1327
<td> current X coordinate
 
1328
</td>
 
1329
</tr>
 
1330
<tr>
 
1331
<td><span class="term"><em class="parameter"><code>current_y</code></em>&#160;:</span></td>
 
1332
<td> current Y coordinate
 
1333
</td>
 
1334
</tr>
 
1335
<tr>
 
1336
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1337
<td> <code class="literal">TRUE</code> if the drag threshold has been passed.
 
1338
</td>
 
1339
</tr>
 
1340
</tbody>
 
1341
</table></div>
 
1342
</div>
 
1343
<hr>
 
1344
<div class="refsect2" lang="en">
 
1345
<a name="id2678339"></a><h3>
 
1346
<a name="gtk-drag-source-set"></a>gtk_drag_source_set ()</h3>
 
1347
<a class="indexterm" name="id2678353"></a><pre class="programlisting">void                gtk_drag_source_set                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1348
                                                         <a
 
1349
href="../gdk/gdk-Windows.html#GdkModifierType"
 
1350
>GdkModifierType</a> start_button_mask,
 
1351
                                                         const <a href="gtk-Selections.html#GtkTargetEntry">GtkTargetEntry</a> *targets,
 
1352
                                                         gint n_targets,
 
1353
                                                         <a
 
1354
href="../gdk/gdk-Drag-and-Drop.html#GdkDragAction"
 
1355
>GdkDragAction</a> actions);</pre>
 
1356
<p>
 
1357
Sets up a widget so that GTK+ will start a drag
 
1358
operation when the user clicks and drags on the
 
1359
widget. The widget must have a window.
 
1360
</p>
 
1361
<div class="variablelist"><table border="0">
 
1362
<col align="left" valign="top">
 
1363
<tbody>
 
1364
<tr>
 
1365
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1366
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1367
</td>
 
1368
</tr>
 
1369
<tr>
 
1370
<td><span class="term"><em class="parameter"><code>start_button_mask</code></em>&#160;:</span></td>
 
1371
<td>the bitmask of buttons that can start the drag
 
1372
</td>
 
1373
</tr>
 
1374
<tr>
 
1375
<td><span class="term"><em class="parameter"><code>targets</code></em>&#160;:</span></td>
 
1376
<td>the table of targets that the drag will support
 
1377
</td>
 
1378
</tr>
 
1379
<tr>
 
1380
<td><span class="term"><em class="parameter"><code>n_targets</code></em>&#160;:</span></td>
 
1381
<td>the number of items in <em class="parameter"><code>targets</code></em>
 
1382
</td>
 
1383
</tr>
 
1384
<tr>
 
1385
<td><span class="term"><em class="parameter"><code>actions</code></em>&#160;:</span></td>
 
1386
<td>the bitmask of possible actions for a drag from this
 
1387
 widget.
 
1388
 
 
1389
 
 
1390
</td>
 
1391
</tr>
 
1392
</tbody>
 
1393
</table></div>
 
1394
</div>
 
1395
<hr>
 
1396
<div class="refsect2" lang="en">
 
1397
<a name="id2678505"></a><h3>
 
1398
<a name="gtk-drag-source-set-icon"></a>gtk_drag_source_set_icon ()</h3>
 
1399
<a class="indexterm" name="id2678518"></a><pre class="programlisting">void                gtk_drag_source_set_icon            (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1400
                                                         <a
 
1401
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
1402
>GdkColormap</a> *colormap,
 
1403
                                                         <a
 
1404
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"
 
1405
>GdkPixmap</a> *pixmap,
 
1406
                                                         <a
 
1407
href="../gdk/gdk-Bitmaps-and-Pixmaps.html#GdkBitmap"
 
1408
>GdkBitmap</a> *mask);</pre>
 
1409
<p>
 
1410
Sets the icon that will be used for drags from a particular widget
 
1411
from a pixmap/mask. GTK+ retains references for the arguments, and 
 
1412
will release them when they are no longer needed.
 
1413
Use <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-icon-pixbuf"><code class="function">gtk_drag_source_set_icon_pixbuf()</code></a> instead.</p>
 
1414
<p>
 
1415
</p>
 
1416
<div class="variablelist"><table border="0">
 
1417
<col align="left" valign="top">
 
1418
<tbody>
 
1419
<tr>
 
1420
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1421
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1422
</td>
 
1423
</tr>
 
1424
<tr>
 
1425
<td><span class="term"><em class="parameter"><code>colormap</code></em>&#160;:</span></td>
 
1426
<td> the colormap of the icon
 
1427
</td>
 
1428
</tr>
 
1429
<tr>
 
1430
<td><span class="term"><em class="parameter"><code>pixmap</code></em>&#160;:</span></td>
 
1431
<td> the image data for the icon
 
1432
</td>
 
1433
</tr>
 
1434
<tr>
 
1435
<td><span class="term"><em class="parameter"><code>mask</code></em>&#160;:</span></td>
 
1436
<td> the transparency mask for an image.
 
1437
</td>
 
1438
</tr>
 
1439
</tbody>
 
1440
</table></div>
 
1441
</div>
 
1442
<hr>
 
1443
<div class="refsect2" lang="en">
 
1444
<a name="id2678656"></a><h3>
 
1445
<a name="gtk-drag-source-set-icon-pixbuf"></a>gtk_drag_source_set_icon_pixbuf ()</h3>
 
1446
<a class="indexterm" name="id2678669"></a><pre class="programlisting">void                gtk_drag_source_set_icon_pixbuf     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1447
                                                         <a
 
1448
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
1449
>GdkPixbuf</a> *pixbuf);</pre>
 
1450
<p>
 
1451
Sets the icon that will be used for drags from a particular widget
 
1452
from a <a
 
1453
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
1454
><span class="type">GdkPixbuf</span></a>. GTK+ retains a reference for <em class="parameter"><code>pixbuf</code></em> and will 
 
1455
release it when it is no longer needed.</p>
 
1456
<p>
 
1457
 
 
1458
</p>
 
1459
<div class="variablelist"><table border="0">
 
1460
<col align="left" valign="top">
 
1461
<tbody>
 
1462
<tr>
 
1463
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1464
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1465
</td>
 
1466
</tr>
 
1467
<tr>
 
1468
<td><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></td>
 
1469
<td> the <a
 
1470
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
1471
><span class="type">GdkPixbuf</span></a> for the drag icon
 
1472
</td>
 
1473
</tr>
 
1474
</tbody>
 
1475
</table></div>
 
1476
</div>
 
1477
<hr>
 
1478
<div class="refsect2" lang="en">
 
1479
<a name="id2678773"></a><h3>
 
1480
<a name="gtk-drag-source-set-icon-stock"></a>gtk_drag_source_set_icon_stock ()</h3>
 
1481
<a class="indexterm" name="id2678786"></a><pre class="programlisting">void                gtk_drag_source_set_icon_stock      (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1482
                                                         const gchar *stock_id);</pre>
 
1483
<p>
 
1484
Sets the icon that will be used for drags from a particular source
 
1485
to a stock icon.</p>
 
1486
<p>
 
1487
 
 
1488
</p>
 
1489
<div class="variablelist"><table border="0">
 
1490
<col align="left" valign="top">
 
1491
<tbody>
 
1492
<tr>
 
1493
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1494
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1495
</td>
 
1496
</tr>
 
1497
<tr>
 
1498
<td><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
 
1499
<td> the ID of the stock icon to use
 
1500
</td>
 
1501
</tr>
 
1502
</tbody>
 
1503
</table></div>
 
1504
</div>
 
1505
<hr>
 
1506
<div class="refsect2" lang="en">
 
1507
<a name="id2678867"></a><h3>
 
1508
<a name="gtk-drag-source-set-icon-name"></a>gtk_drag_source_set_icon_name ()</h3>
 
1509
<a class="indexterm" name="id2678882"></a><pre class="programlisting">void                gtk_drag_source_set_icon_name       (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1510
                                                         const gchar *icon_name);</pre>
 
1511
<p>
 
1512
Sets the icon that will be used for drags from a particular source
 
1513
to a themed icon. See the docs for <a href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.</p>
 
1514
<p>
 
1515
 
 
1516
</p>
 
1517
<div class="variablelist"><table border="0">
 
1518
<col align="left" valign="top">
 
1519
<tbody>
 
1520
<tr>
 
1521
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1522
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1523
</td>
 
1524
</tr>
 
1525
<tr>
 
1526
<td><span class="term"><em class="parameter"><code>icon_name</code></em>&#160;:</span></td>
 
1527
<td> name of icon to use
 
1528
</td>
 
1529
</tr>
 
1530
</tbody>
 
1531
</table></div>
 
1532
<p class="since">Since  2.8
 
1533
</p>
 
1534
</div>
 
1535
<hr>
 
1536
<div class="refsect2" lang="en">
 
1537
<a name="id2678979"></a><h3>
 
1538
<a name="gtk-drag-source-unset"></a>gtk_drag_source_unset ()</h3>
 
1539
<a class="indexterm" name="id2678992"></a><pre class="programlisting">void                gtk_drag_source_unset               (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
1540
<p>
 
1541
Undoes the effects of <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set"><code class="function">gtk_drag_source_set()</code></a>.
 
1542
</p>
 
1543
<div class="variablelist"><table border="0">
 
1544
<col align="left" valign="top">
 
1545
<tbody><tr>
 
1546
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1547
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1548
 
 
1549
 
 
1550
</td>
 
1551
</tr></tbody>
 
1552
</table></div>
 
1553
</div>
 
1554
<hr>
 
1555
<div class="refsect2" lang="en">
 
1556
<a name="id2679057"></a><h3>
 
1557
<a name="gtk-drag-source-set-target-list"></a>gtk_drag_source_set_target_list ()</h3>
 
1558
<a class="indexterm" name="id2679073"></a><pre class="programlisting">void                gtk_drag_source_set_target_list     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
 
1559
                                                         <a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *target_list);</pre>
 
1560
<p>
 
1561
Changes the target types that this widget offers for drag-and-drop.
 
1562
The widget must first be made into a drag source with
 
1563
<a href="gtk-Drag-and-Drop.html#gtk-drag-source-set"><code class="function">gtk_drag_source_set()</code></a>.</p>
 
1564
<p>
 
1565
 
 
1566
</p>
 
1567
<div class="variablelist"><table border="0">
 
1568
<col align="left" valign="top">
 
1569
<tbody>
 
1570
<tr>
 
1571
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1572
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's a drag source
 
1573
</td>
 
1574
</tr>
 
1575
<tr>
 
1576
<td><span class="term"><em class="parameter"><code>target_list</code></em>&#160;:</span></td>
 
1577
<td> list of draggable targets, or <a
 
1578
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
1579
><code class="literal">NULL</code></a> for none
 
1580
</td>
 
1581
</tr>
 
1582
</tbody>
 
1583
</table></div>
 
1584
<p class="since">Since  2.4
 
1585
</p>
 
1586
</div>
 
1587
<hr>
 
1588
<div class="refsect2" lang="en">
 
1589
<a name="id2679183"></a><h3>
 
1590
<a name="gtk-drag-source-get-target-list"></a>gtk_drag_source_get_target_list ()</h3>
 
1591
<a class="indexterm" name="id2679198"></a><pre class="programlisting"><a href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      gtk_drag_source_get_target_list     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
1592
<p>
 
1593
Gets the list of targets this widget can provide for
 
1594
drag-and-drop.</p>
 
1595
<p>
 
1596
 
 
1597
</p>
 
1598
<div class="variablelist"><table border="0">
 
1599
<col align="left" valign="top">
 
1600
<tbody>
 
1601
<tr>
 
1602
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1603
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
 
1604
</td>
 
1605
</tr>
 
1606
<tr>
 
1607
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1608
<td> the <a href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>, or <a
 
1609
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
1610
><code class="literal">NULL</code></a> if none
 
1611
 
 
1612
</td>
 
1613
</tr>
 
1614
</tbody>
 
1615
</table></div>
 
1616
<p class="since">Since  2.4
 
1617
</p>
 
1618
</div>
 
1619
<hr>
 
1620
<div class="refsect2" lang="en">
 
1621
<a name="id2679293"></a><h3>
 
1622
<a name="gtk-drag-source-add-text-targets"></a>gtk_drag_source_add_text_targets ()</h3>
 
1623
<a class="indexterm" name="id2679308"></a><pre class="programlisting">void                gtk_drag_source_add_text_targets    (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
1624
<p>
 
1625
Add the text targets supported by <span class="type">GtkSelection</span> to
 
1626
the target list of the drag source.  The targets
 
1627
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
1628
use <a href="gtk-Selections.html#gtk-target-list-add-text-targets"><code class="function">gtk_target_list_add_text_targets()</code></a> and
 
1629
<a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-target-list"><code class="function">gtk_drag_source_set_target_list()</code></a>.</p>
 
1630
<p>
 
1631
 
 
1632
</p>
 
1633
<div class="variablelist"><table border="0">
 
1634
<col align="left" valign="top">
 
1635
<tbody><tr>
 
1636
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1637
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's is a drag source
 
1638
</td>
 
1639
</tr></tbody>
 
1640
</table></div>
 
1641
<p class="since">Since  2.6
 
1642
</p>
 
1643
</div>
 
1644
<hr>
 
1645
<div class="refsect2" lang="en">
 
1646
<a name="id2679412"></a><h3>
 
1647
<a name="gtk-drag-source-add-image-targets"></a>gtk_drag_source_add_image_targets ()</h3>
 
1648
<a class="indexterm" name="id2679429"></a><pre class="programlisting">void                gtk_drag_source_add_image_targets   (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
1649
<p>
 
1650
Add the writable image targets supported by <span class="type">GtkSelection</span> to
 
1651
the target list of the drag source. The targets
 
1652
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
1653
use <a href="gtk-Selections.html#gtk-target-list-add-image-targets"><code class="function">gtk_target_list_add_image_targets()</code></a> and
 
1654
<a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-target-list"><code class="function">gtk_drag_source_set_target_list()</code></a>.</p>
 
1655
<p>
 
1656
 
 
1657
</p>
 
1658
<div class="variablelist"><table border="0">
 
1659
<col align="left" valign="top">
 
1660
<tbody><tr>
 
1661
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1662
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's is a drag source
 
1663
</td>
 
1664
</tr></tbody>
 
1665
</table></div>
 
1666
<p class="since">Since  2.6
 
1667
</p>
 
1668
</div>
 
1669
<hr>
 
1670
<div class="refsect2" lang="en">
 
1671
<a name="id2679532"></a><h3>
 
1672
<a name="gtk-drag-source-add-uri-targets"></a>gtk_drag_source_add_uri_targets ()</h3>
 
1673
<a class="indexterm" name="id2679548"></a><pre class="programlisting">void                gtk_drag_source_add_uri_targets     (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
 
1674
<p>
 
1675
Add the URI targets supported by <span class="type">GtkSelection</span> to
 
1676
the target list of the drag source.  The targets
 
1677
are added with <em class="parameter"><code>info</code></em> = 0. If you need another value, 
 
1678
use <a href="gtk-Selections.html#gtk-target-list-add-uri-targets"><code class="function">gtk_target_list_add_uri_targets()</code></a> and
 
1679
<a href="gtk-Drag-and-Drop.html#gtk-drag-source-set-target-list"><code class="function">gtk_drag_source_set_target_list()</code></a>.</p>
 
1680
<p>
 
1681
 
 
1682
</p>
 
1683
<div class="variablelist"><table border="0">
 
1684
<col align="left" valign="top">
 
1685
<tbody><tr>
 
1686
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
 
1687
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that's is a drag source
 
1688
</td>
 
1689
</tr></tbody>
 
1690
</table></div>
 
1691
<p class="since">Since  2.6
 
1692
</p>
 
1693
</div>
 
1694
</div>
 
1695
</div>
 
1696
</body>
 
1697
</html>