Pileus Git - ~andy/gtk/blob - gtk/gtkdnd.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1999 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /*
  21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  22  * file for a list of people on the GTK+ Team.  See the ChangeLog
  23  * files for a list of changes.  These files are distributed with
  24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  25  */
  26
  27 #include "config.h"
  28
  29 #include <stdlib.h>
  30 #include <string.h>
  31
  32 #include "gdkconfig.h"
  33
  34 #include "gdk/gdkkeysyms.h"
  35
  36 #ifdef GDK_WINDOWING_X11
  37 #include <X11/Xlib.h>
  38 #include <X11/keysym.h>
  39 #include "gdk/x11/gdkx.h"
  40 #endif
  41
  42 #include "gtkdnd.h"
  43 #include "gtkiconfactory.h"
  44 #include "gtkicontheme.h"
  45 #include "gtkimage.h"
  46 #include "gtkinvisible.h"
  47 #include "gtkmain.h"
  48 #include "gtkplug.h"
  49 #include "gtkstock.h"
  50 #include "gtkwindow.h"
  51 #include "gtkintl.h"
  52 #include "gtkdndcursors.h"
  53 #include "gtkalias.h"
  54
  55 static GSList *source_widgets = NULL;
  56
  57 typedef struct _GtkDragSourceSite GtkDragSourceSite;
  58 typedef struct _GtkDragSourceInfo GtkDragSourceInfo;
  59 typedef struct _GtkDragDestSite GtkDragDestSite;
  60 typedef struct _GtkDragDestInfo GtkDragDestInfo;
  61 typedef struct _GtkDragAnim GtkDragAnim;
  62 typedef struct _GtkDragFindData GtkDragFindData;
  63
  64
  65 typedef enum
  66 {
  67   GTK_DRAG_STATUS_DRAG,
  68   GTK_DRAG_STATUS_WAIT,
  69   GTK_DRAG_STATUS_DROP
  70 } GtkDragStatus;
  71
  72 struct _GtkDragSourceSite
  73 {
  74   GdkModifierType    start_button_mask;
  75   GtkTargetList     *target_list;        /* Targets for drag data */
  76   GdkDragAction      actions;            /* Possible actions */
  77
  78   /* Drag icon */
  79   GtkImageType icon_type;
  80   union
  81   {
  82     GtkImagePixmapData pixmap;
  83     GtkImagePixbufData pixbuf;
  84     GtkImageStockData stock;
  85     GtkImageIconNameData name;
  86   } icon_data;
  87   GdkBitmap *icon_mask;
  88
  89   GdkColormap       *colormap;           /* Colormap for drag icon */
  90
  91   /* Stored button press information to detect drag beginning */
  92   gint               state;
  93   gint               x, y;
  94 };
  95
  96 struct _GtkDragSourceInfo
  97 {
  98   GtkWidget         *widget;
  99   GtkTargetList     *target_list; /* Targets for drag data */
 100   GdkDragAction      possible_actions; /* Actions allowed by source */
 101   GdkDragContext    *context;     /* drag context */
 102   GtkWidget         *icon_window; /* Window for drag */
 103   GtkWidget         *fallback_icon; /* Window for drag used on other screens */
 104   GtkWidget         *ipc_widget;  /* GtkInvisible for grab, message passing */
 105   GdkCursor         *cursor;      /* Cursor for drag */
 106   gint hot_x, hot_y;              /* Hot spot for drag */
 107   gint button;                    /* mouse button starting drag */
 108
 109   GtkDragStatus      status;      /* drag status */
 110   GdkEvent          *last_event;  /* pending event */
 111
 112   gint               start_x, start_y; /* Initial position */
 113   gint               cur_x, cur_y;     /* Current Position */
 114   GdkScreen         *cur_screen;       /* Current screen for pointer */
 115
 116   guint32            grab_time;   /* timestamp for initial grab */
 117   GList             *selections;  /* selections we've claimed */
 118
 119   GtkDragDestInfo   *proxy_dest;  /* Set if this is a proxy drag */
 120
 121   guint              update_idle;      /* Idle function to update the drag */
 122   guint              drop_timeout;     /* Timeout for aborting drop */
 123   guint              destroy_icon : 1; /* If true, destroy icon_window
 124                                         */
 125   guint              have_grab : 1;    /* Do we still have the pointer grab
 126                                         */
 127   GdkPixbuf         *icon_pixbuf;
 128   GdkCursor         *drag_cursors[6];
 129 };
 130
 131 struct _GtkDragDestSite
 132 {
 133   GtkDestDefaults    flags;
 134   GtkTargetList     *target_list;
 135   GdkDragAction      actions;
 136   GdkWindow         *proxy_window;
 137   GdkDragProtocol    proxy_protocol;
 138   guint              do_proxy : 1;
 139   guint              proxy_coords : 1;
 140   guint              have_drag : 1;
 141   guint              track_motion : 1;
 142 };
 143
 144 struct _GtkDragDestInfo
 145 {
 146   GtkWidget         *widget;       /* Widget in which drag is in */
 147   GdkDragContext    *context;      /* Drag context */
 148   GtkDragSourceInfo *proxy_source; /* Set if this is a proxy drag */
 149   GtkSelectionData  *proxy_data;   /* Set while retrieving proxied data */
 150   guint              dropped : 1;     /* Set after we receive a drop */
 151   guint32            proxy_drop_time; /* Timestamp for proxied drop */
 152   guint              proxy_drop_wait : 1; /* Set if we are waiting for a
 153                                            * status reply before sending
 154                                            * a proxied drop on.
 155                                            */
 156   gint               drop_x, drop_y; /* Position of drop */
 157 };
 158
 159 #define DROP_ABORT_TIME 300000
 160
 161 #define ANIM_STEP_TIME 50
 162 #define ANIM_STEP_LENGTH 50
 163 #define ANIM_MIN_STEPS 5
 164 #define ANIM_MAX_STEPS 10
 165
 166 struct _GtkDragAnim
 167 {
 168   GtkDragSourceInfo *info;
 169   gint step;
 170   gint n_steps;
 171 };
 172
 173 struct _GtkDragFindData
 174 {
 175   gint x;
 176   gint y;
 177   GdkDragContext *context;
 178   GtkDragDestInfo *info;
 179   gboolean found;
 180   gboolean toplevel;
 181   gboolean (*callback) (GtkWidget *widget, GdkDragContext *context,
 182                         gint x, gint y, guint32 time);
 183   guint32 time;
 184 };
 185
 186 /* Enumeration for some targets we handle internally */
 187
 188 enum {
 189   TARGET_MOTIF_SUCCESS = 0x40000000,
 190   TARGET_MOTIF_FAILURE,
 191   TARGET_DELETE
 192 };
 193
 194 /* Drag icons */
 195
 196 static GdkPixmap   *default_icon_pixmap = NULL;
 197 static GdkPixmap   *default_icon_mask = NULL;
 198 static GdkColormap *default_icon_colormap = NULL;
 199 static gint         default_icon_hot_x;
 200 static gint         default_icon_hot_y;
 201
 202 /* Forward declarations */
 203 static void          gtk_drag_get_event_actions (GdkEvent        *event,
 204                                                  gint             button,
 205                                                  GdkDragAction    actions,
 206                                                  GdkDragAction   *suggested_action,
 207                                                  GdkDragAction   *possible_actions);
 208 static GdkCursor *   gtk_drag_get_cursor         (GdkDisplay     *display,
 209                                                   GdkDragAction   action,
 210                                                   GtkDragSourceInfo *info);
 211 static void          gtk_drag_update_cursor      (GtkDragSourceInfo *info);
 212 static GtkWidget    *gtk_drag_get_ipc_widget            (GtkWidget *widget);
 213 static GtkWidget    *gtk_drag_get_ipc_widget_for_screen (GdkScreen *screen);
 214 static void          gtk_drag_release_ipc_widget (GtkWidget      *widget);
 215
 216 static gboolean      gtk_drag_highlight_expose   (GtkWidget      *widget,
 217                                                   GdkEventExpose *event,
 218                                                   gpointer        data);
 219
 220 static void     gtk_drag_selection_received     (GtkWidget        *widget,
 221                                                  GtkSelectionData *selection_data,
 222                                                  guint             time,
 223                                                  gpointer          data);
 224 static void     gtk_drag_find_widget            (GtkWidget        *widget,
 225                                                  GtkDragFindData  *data);
 226 static void     gtk_drag_proxy_begin            (GtkWidget        *widget,
 227                                                  GtkDragDestInfo  *dest_info,
 228                                                  guint32           time);
 229 static void     gtk_drag_dest_realized          (GtkWidget        *widget);
 230 static void     gtk_drag_dest_hierarchy_changed (GtkWidget        *widget,
 231                                                  GtkWidget        *previous_toplevel);
 232 static void     gtk_drag_dest_site_destroy      (gpointer          data);
 233 static void     gtk_drag_dest_leave             (GtkWidget        *widget,
 234                                                  GdkDragContext   *context,
 235                                                  guint             time);
 236 static gboolean gtk_drag_dest_motion            (GtkWidget        *widget,
 237                                                  GdkDragContext   *context,
 238                                                  gint              x,
 239                                                  gint              y,
 240                                                  guint             time);
 241 static gboolean gtk_drag_dest_drop              (GtkWidget        *widget,
 242                                                  GdkDragContext   *context,
 243                                                  gint              x,
 244                                                  gint              y,
 245                                                  guint             time);
 246
 247 static GtkDragDestInfo *  gtk_drag_get_dest_info     (GdkDragContext *context,
 248                                                       gboolean        create);
 249 static GtkDragSourceInfo *gtk_drag_get_source_info   (GdkDragContext *context,
 250                                                       gboolean        create);
 251 static void               gtk_drag_clear_source_info (GdkDragContext *context);
 252
 253 static void gtk_drag_source_check_selection    (GtkDragSourceInfo *info,
 254                                                 GdkAtom            selection,
 255                                                 guint32            time);
 256 static void gtk_drag_source_release_selections (GtkDragSourceInfo *info,
 257                                                 guint32            time);
 258 static void gtk_drag_drop                      (GtkDragSourceInfo *info,
 259                                                 guint32            time);
 260 static void gtk_drag_drop_finished             (GtkDragSourceInfo *info,
 261                                                 GtkDragResult      result,
 262                                                 guint              time);
 263 static void gtk_drag_cancel                    (GtkDragSourceInfo *info,
 264                                                 GtkDragResult      result,
 265                                                 guint32            time);
 266
 267 static gboolean gtk_drag_source_event_cb       (GtkWidget         *widget,
 268                                                 GdkEvent          *event,
 269                                                 gpointer           data);
 270 static void gtk_drag_source_site_destroy       (gpointer           data);
 271 static void gtk_drag_selection_get             (GtkWidget         *widget,
 272                                                 GtkSelectionData  *selection_data,
 273                                                 guint              sel_info,
 274                                                 guint32            time,
 275                                                 gpointer           data);
 276 static gboolean gtk_drag_anim_timeout          (gpointer           data);
 277 static void gtk_drag_remove_icon               (GtkDragSourceInfo *info);
 278 static void gtk_drag_source_info_destroy       (GtkDragSourceInfo *info);
 279 static void gtk_drag_add_update_idle           (GtkDragSourceInfo *info);
 280
 281 static void gtk_drag_update                    (GtkDragSourceInfo *info,
 282                                                 GdkScreen         *screen,
 283                                                 gint               x_root,
 284                                                 gint               y_root,
 285                                                 GdkEvent          *event);
 286 static gboolean gtk_drag_motion_cb             (GtkWidget         *widget,
 287                                                 GdkEventMotion    *event,
 288                                                 gpointer           data);
 289 static gboolean gtk_drag_key_cb                (GtkWidget         *widget,
 290                                                 GdkEventKey       *event,
 291                                                 gpointer           data);
 292 static gboolean gtk_drag_grab_broken_event_cb  (GtkWidget          *widget,
 293                                                 GdkEventGrabBroken *event,
 294                                                 gpointer            data);
 295 static void     gtk_drag_grab_notify_cb        (GtkWidget         *widget,
 296                                                 gboolean           was_grabbed,
 297                                                 gpointer           data);
 298 static gboolean gtk_drag_button_release_cb     (GtkWidget         *widget,
 299                                                 GdkEventButton    *event,
 300                                                 gpointer           data);
 301 static gboolean gtk_drag_abort_timeout         (gpointer           data);
 302
 303 static void     set_icon_stock_pixbuf          (GdkDragContext    *context,
 304                                                 const gchar       *stock_id,
 305                                                 GdkPixbuf         *pixbuf,
 306                                                 gint               hot_x,
 307                                                 gint               hot_y,
 308                                                 gboolean           force_window);
 309
 310 /************************
 311  * Cursor and Icon data *
 312  ************************/
 313
 314 static struct {
 315   GdkDragAction action;
 316   const gchar  *name;
 317   const guint8 *data;
 318   GdkPixbuf    *pixbuf;
 319   GdkCursor    *cursor;
 320 } drag_cursors[] = {
 321   { GDK_ACTION_DEFAULT, NULL },
 322   { GDK_ACTION_ASK,   "dnd-ask",  dnd_cursor_ask,  NULL, NULL },
 323   { GDK_ACTION_COPY,  "dnd-copy", dnd_cursor_copy, NULL, NULL },
 324   { GDK_ACTION_MOVE,  "dnd-move", dnd_cursor_move, NULL, NULL },
 325   { GDK_ACTION_LINK,  "dnd-link", dnd_cursor_link, NULL, NULL },
 326   { 0              ,  "dnd-none", dnd_cursor_none, NULL, NULL },
 327 };
 328
 329 static const gint n_drag_cursors = sizeof (drag_cursors) / sizeof (drag_cursors[0]);
 330
 331 /*********************
 332  * Utility functions *
 333  *********************/
 334
 335 static void
 336 set_can_change_screen (GtkWidget *widget,
 337                        gboolean   can_change_screen)
 338 {
 339   can_change_screen = can_change_screen != FALSE;
 340
 341   g_object_set_data (G_OBJECT (widget), I_("gtk-dnd-can-change-screen"),
 342                      GUINT_TO_POINTER (can_change_screen));
 343 }
 344
 345 static gboolean
 346 get_can_change_screen (GtkWidget *widget)
 347 {
 348   return g_object_get_data (G_OBJECT (widget), "gtk-dnd-can-change-screen") != NULL;
 349
 350 }
 351
 352 static GtkWidget *
 353 gtk_drag_get_ipc_widget_for_screen (GdkScreen *screen)
 354 {
 355   GtkWidget *result;
 356   GSList *drag_widgets = g_object_get_data (G_OBJECT (screen),
 357                                             "gtk-dnd-ipc-widgets");
 358
 359   if (drag_widgets)
 360     {
 361       GSList *tmp = drag_widgets;
 362       result = drag_widgets->data;
 363       drag_widgets = drag_widgets->next;
 364       g_object_set_data (G_OBJECT (screen),
 365                          I_("gtk-dnd-ipc-widgets"),
 366                          drag_widgets);
 367       g_slist_free_1 (tmp);
 368     }
 369   else
 370     {
 371       result = gtk_window_new (GTK_WINDOW_POPUP);
 372       gtk_window_set_screen (GTK_WINDOW (result), screen);
 373       gtk_window_resize (GTK_WINDOW (result), 1, 1);
 374       gtk_window_move (GTK_WINDOW (result), -100, -100);
 375       gtk_widget_show (result);
 376     }
 377
 378   return result;
 379 }
 380
 381 static GtkWidget *
 382 gtk_drag_get_ipc_widget (GtkWidget *widget)
 383 {
 384   GtkWidget *result;
 385   GtkWidget *toplevel;
 386
 387   result = gtk_drag_get_ipc_widget_for_screen (gtk_widget_get_screen (widget));
 388
 389   toplevel = gtk_widget_get_toplevel (widget);
 390
 391   if (GTK_IS_WINDOW (toplevel))
 392     {
 393       if (GTK_WINDOW (toplevel)->group)
 394         gtk_window_group_add_window (GTK_WINDOW (toplevel)->group,
 395                                      GTK_WINDOW (result));
 396     }
 397
 398   return result;
 399 }
 400
 401
 402 #ifdef GDK_WINDOWING_X11
 403
 404 /*
 405  * We want to handle a handful of keys during DND, e.g. Escape to abort.
 406  * Grabbing the keyboard has the unfortunate side-effect of preventing
 407  * useful things such as using Alt-Tab to cycle between windows or
 408  * switching workspaces. Therefore, we just grab the few keys we are
 409  * interested in. Note that we need to put the grabs on the root window
 410  * in order for them to still work when the focus is moved to another
 411  * app/workspace.
 412  *
 413  * GDK needs a little help to successfully deliver root key events...
 414  */
 415
 416 static GdkFilterReturn
 417 root_key_filter (GdkXEvent *xevent,
 418                  GdkEvent  *event,
 419                  gpointer   data)
 420 {
 421   XEvent *ev = (XEvent *)xevent;
 422
 423   if ((ev->type == KeyPress || ev->type == KeyRelease) &&
 424       ev->xkey.root == ev->xkey.window)
 425     ev->xkey.window = (Window)data;
 426
 427   return GDK_FILTER_CONTINUE;
 428 }
 429
 430 typedef struct {
 431   gint keysym;
 432   gint modifiers;
 433 } GrabKey;
 434
 435 static GrabKey grab_keys[] = {
 436   { XK_Escape, 0 },
 437   { XK_space, 0 },
 438   { XK_KP_Space, 0 },
 439   { XK_Return, 0 },
 440   { XK_KP_Enter, 0 },
 441   { XK_Up, 0 },
 442   { XK_Up, Mod1Mask },
 443   { XK_Down, 0 },
 444   { XK_Down, Mod1Mask },
 445   { XK_Left, 0 },
 446   { XK_Left, Mod1Mask },
 447   { XK_Right, 0 },
 448   { XK_Right, Mod1Mask },
 449   { XK_KP_Up, 0 },
 450   { XK_KP_Up, Mod1Mask },
 451   { XK_KP_Down, 0 },
 452   { XK_KP_Down, Mod1Mask },
 453   { XK_KP_Left, 0 },
 454   { XK_KP_Left, Mod1Mask },
 455   { XK_KP_Right, 0 },
 456   { XK_KP_Right, Mod1Mask }
 457 };
 458
 459 static void
 460 grab_dnd_keys (GtkWidget *widget,
 461                guint32    time)
 462 {
 463   guint i;
 464   GdkWindow *window, *root;
 465   gint keycode;
 466
 467   window = widget->window;
 468   root = gdk_screen_get_root_window (gtk_widget_get_screen (widget));
 469
 470   gdk_error_trap_push ();
 471
 472   for (i = 0; i < G_N_ELEMENTS (grab_keys); ++i)
 473     {
 474       keycode = XKeysymToKeycode (GDK_WINDOW_XDISPLAY (window), grab_keys[i].keysym);
 475       XGrabKey (GDK_WINDOW_XDISPLAY (window),
 476                 keycode, grab_keys[i].modifiers,
 477                 GDK_WINDOW_XID (root),
 478                 FALSE,
 479                 GrabModeAsync,
 480                 GrabModeAsync);
 481     }
 482
 483   gdk_flush ();
 484   gdk_error_trap_pop ();
 485
 486   gdk_window_add_filter (NULL, root_key_filter, (gpointer) GDK_WINDOW_XID (window));
 487 }
 488
 489 static void
 490 ungrab_dnd_keys (GtkWidget *widget,
 491                  guint32    time)
 492 {
 493   guint i;
 494   GdkWindow *window, *root;
 495   gint keycode;
 496
 497   window = widget->window;
 498   root = gdk_screen_get_root_window (gtk_widget_get_screen (widget));
 499
 500   gdk_window_remove_filter (NULL, root_key_filter, (gpointer) GDK_WINDOW_XID (window));
 501
 502   gdk_error_trap_push ();
 503
 504   for (i = 0; i < G_N_ELEMENTS (grab_keys); ++i)
 505     {
 506       keycode = XKeysymToKeycode (GDK_WINDOW_XDISPLAY (window), grab_keys[i].keysym);
 507       XUngrabKey (GDK_WINDOW_XDISPLAY (window),
 508                   keycode, grab_keys[i].modifiers,
 509                   GDK_WINDOW_XID (root));
 510     }
 511
 512   gdk_flush ();
 513   gdk_error_trap_pop ();
 514 }
 515
 516 #else
 517
 518 static void
 519 grab_dnd_keys (GtkWidget *widget,
 520                guint32    time)
 521 {
 522   gdk_keyboard_grab (widget->window, FALSE, time);
 523 }
 524
 525 static void
 526 ungrab_dnd_keys (GtkWidget *widget,
 527                  guint32    time)
 528 {
 529   gdk_display_keyboard_ungrab (gtk_widget_get_display (widget), time);
 530 }
 531
 532 #endif
 533
 534
 535 /***************************************************************
 536  * gtk_drag_release_ipc_widget:
 537  *     Releases widget retrieved with gtk_drag_get_ipc_widget ()
 538  *   arguments:
 539  *     widget: the widget to release.
 540  *   results:
 541  ***************************************************************/
 542
 543 static void
 544 gtk_drag_release_ipc_widget (GtkWidget *widget)
 545 {
 546   GtkWindow *window = GTK_WINDOW (widget);
 547   GdkScreen *screen = gtk_widget_get_screen (widget);
 548   GSList *drag_widgets = g_object_get_data (G_OBJECT (screen),
 549                                             "gtk-dnd-ipc-widgets");
 550   ungrab_dnd_keys (widget, GDK_CURRENT_TIME);
 551   if (window->group)
 552     gtk_window_group_remove_window (window->group, window);
 553   drag_widgets = g_slist_prepend (drag_widgets, widget);
 554   g_object_set_data (G_OBJECT (screen),
 555                      I_("gtk-dnd-ipc-widgets"),
 556                      drag_widgets);
 557 }
 558
 559 static guint32
 560 gtk_drag_get_event_time (GdkEvent *event)
 561 {
 562   guint32 tm = GDK_CURRENT_TIME;
 563
 564   if (event)
 565     switch (event->type)
 566       {
 567       case GDK_MOTION_NOTIFY:
 568         tm = event->motion.time; break;
 569       case GDK_BUTTON_PRESS:
 570       case GDK_2BUTTON_PRESS:
 571       case GDK_3BUTTON_PRESS:
 572       case GDK_BUTTON_RELEASE:
 573         tm = event->button.time; break;
 574       case GDK_KEY_PRESS:
 575       case GDK_KEY_RELEASE:
 576         tm = event->key.time; break;
 577       case GDK_ENTER_NOTIFY:
 578       case GDK_LEAVE_NOTIFY:
 579         tm = event->crossing.time; break;
 580       case GDK_PROPERTY_NOTIFY:
 581         tm = event->property.time; break;
 582       case GDK_SELECTION_CLEAR:
 583       case GDK_SELECTION_REQUEST:
 584       case GDK_SELECTION_NOTIFY:
 585         tm = event->selection.time; break;
 586       case GDK_PROXIMITY_IN:
 587       case GDK_PROXIMITY_OUT:
 588         tm = event->proximity.time; break;
 589       default:                  /* use current time */
 590         break;
 591       }
 592
 593   return tm;
 594 }
 595
 596 static void
 597 gtk_drag_get_event_actions (GdkEvent *event,
 598                             gint button,
 599                             GdkDragAction  actions,
 600                             GdkDragAction *suggested_action,
 601                             GdkDragAction *possible_actions)
 602 {
 603   *suggested_action = 0;
 604   *possible_actions = 0;
 605
 606   if (event)
 607     {
 608       GdkModifierType state = 0;
 609
 610       switch (event->type)
 611         {
 612         case GDK_MOTION_NOTIFY:
 613           state = event->motion.state;
 614           break;
 615         case GDK_BUTTON_PRESS:
 616         case GDK_2BUTTON_PRESS:
 617         case GDK_3BUTTON_PRESS:
 618         case GDK_BUTTON_RELEASE:
 619           state = event->button.state;
 620           break;
 621         case GDK_KEY_PRESS:
 622         case GDK_KEY_RELEASE:
 623           state = event->key.state;
 624           break;
 625         case GDK_ENTER_NOTIFY:
 626         case GDK_LEAVE_NOTIFY:
 627           state = event->crossing.state;
 628           break;
 629         default:
 630           break;
 631         }
 632
 633       if ((button == 2 || button == 3) && (actions & GDK_ACTION_ASK))
 634         {
 635           *suggested_action = GDK_ACTION_ASK;
 636           *possible_actions = actions;
 637         }
 638       else if (state & (GDK_SHIFT_MASK | GDK_CONTROL_MASK))
 639         {
 640           if ((state & GDK_SHIFT_MASK) && (state & GDK_CONTROL_MASK))
 641             {
 642               if (actions & GDK_ACTION_LINK)
 643                 {
 644                   *suggested_action = GDK_ACTION_LINK;
 645                   *possible_actions = GDK_ACTION_LINK;
 646                 }
 647             }
 648           else if (state & GDK_CONTROL_MASK)
 649             {
 650               if (actions & GDK_ACTION_COPY)
 651                 {
 652                   *suggested_action = GDK_ACTION_COPY;
 653                   *possible_actions = GDK_ACTION_COPY;
 654                 }
 655               return;
 656             }
 657           else
 658             {
 659               if (actions & GDK_ACTION_MOVE)
 660                 {
 661                   *suggested_action = GDK_ACTION_MOVE;
 662                   *possible_actions = GDK_ACTION_MOVE;
 663                 }
 664               return;
 665             }
 666         }
 667       else
 668         {
 669           *possible_actions = actions;
 670
 671           if ((state & (GDK_MOD1_MASK)) && (actions & GDK_ACTION_ASK))
 672             *suggested_action = GDK_ACTION_ASK;
 673           else if (actions & GDK_ACTION_COPY)
 674             *suggested_action =  GDK_ACTION_COPY;
 675           else if (actions & GDK_ACTION_MOVE)
 676             *suggested_action = GDK_ACTION_MOVE;
 677           else if (actions & GDK_ACTION_LINK)
 678             *suggested_action = GDK_ACTION_LINK;
 679         }
 680     }
 681   else
 682     {
 683       *possible_actions = actions;
 684
 685       if (actions & GDK_ACTION_COPY)
 686         *suggested_action =  GDK_ACTION_COPY;
 687       else if (actions & GDK_ACTION_MOVE)
 688         *suggested_action = GDK_ACTION_MOVE;
 689       else if (actions & GDK_ACTION_LINK)
 690         *suggested_action = GDK_ACTION_LINK;
 691     }
 692 }
 693
 694 static gboolean
 695 gtk_drag_can_use_rgba_cursor (GdkDisplay *display,
 696                               gint        width,
 697                               gint        height)
 698 {
 699   guint max_width, max_height;
 700
 701   if (!gdk_display_supports_cursor_color (display))
 702     return FALSE;
 703
 704   if (!gdk_display_supports_cursor_alpha (display))
 705     return FALSE;
 706
 707   gdk_display_get_maximal_cursor_size (display,
 708                                        &max_width,
 709                                        &max_height);
 710   if (width > max_width || height > max_height)
 711     {
 712        /* can't use rgba cursor (too large) */
 713       return FALSE;
 714     }
 715
 716   return TRUE;
 717 }
 718
 719 static GdkCursor *
 720 gtk_drag_get_cursor (GdkDisplay        *display,
 721                      GdkDragAction      action,
 722                      GtkDragSourceInfo *info)
 723 {
 724   gint i;
 725
 726   /* reconstruct the cursors for each new drag (thus !info),
 727    * to catch cursor theme changes
 728    */
 729   if (!info)
 730     {
 731       for (i = 0 ; i < n_drag_cursors - 1; i++)
 732         if (drag_cursors[i].cursor != NULL)
 733           {
 734             gdk_cursor_unref (drag_cursors[i].cursor);
 735             drag_cursors[i].cursor = NULL;
 736           }
 737     }
 738
 739   for (i = 0 ; i < n_drag_cursors - 1; i++)
 740     if (drag_cursors[i].action == action)
 741       break;
 742
 743   if (drag_cursors[i].pixbuf == NULL)
 744     drag_cursors[i].pixbuf =
 745       gdk_pixbuf_new_from_inline (-1, drag_cursors[i].data, FALSE, NULL);
 746
 747   if (drag_cursors[i].cursor != NULL)
 748     {
 749       if (display != gdk_cursor_get_display (drag_cursors[i].cursor))
 750         {
 751           gdk_cursor_unref (drag_cursors[i].cursor);
 752           drag_cursors[i].cursor = NULL;
 753         }
 754     }
 755
 756   if (drag_cursors[i].cursor == NULL)
 757     drag_cursors[i].cursor = gdk_cursor_new_from_name (display, drag_cursors[i].name);
 758
 759   if (drag_cursors[i].cursor == NULL)
 760     drag_cursors[i].cursor = gdk_cursor_new_from_pixbuf (display, drag_cursors[i].pixbuf, 0, 0);
 761
 762   if (info && info->icon_pixbuf)
 763     {
 764       gint cursor_width, cursor_height;
 765       gint icon_width, icon_height;
 766       gint width, height;
 767       GdkPixbuf *cursor_pixbuf, *pixbuf;
 768       gint hot_x, hot_y;
 769       gint icon_x, icon_y, ref_x, ref_y;
 770
 771       if (info->drag_cursors[i] != NULL)
 772         {
 773           if (display == gdk_cursor_get_display (info->drag_cursors[i]))
 774             return info->drag_cursors[i];
 775
 776           gdk_cursor_unref (info->drag_cursors[i]);
 777           info->drag_cursors[i] = NULL;
 778         }
 779
 780       icon_x = info->hot_x;
 781       icon_y = info->hot_y;
 782       icon_width = gdk_pixbuf_get_width (info->icon_pixbuf);
 783       icon_height = gdk_pixbuf_get_height (info->icon_pixbuf);
 784
 785       hot_x = hot_y = 0;
 786       cursor_pixbuf = gdk_cursor_get_image (drag_cursors[i].cursor);
 787       if (!cursor_pixbuf)
 788         cursor_pixbuf = g_object_ref (drag_cursors[i].pixbuf);
 789       else
 790         {
 791           if (gdk_pixbuf_get_option (cursor_pixbuf, "x_hot"))
 792             hot_x = atoi (gdk_pixbuf_get_option (cursor_pixbuf, "x_hot"));
 793
 794           if (gdk_pixbuf_get_option (cursor_pixbuf, "y_hot"))
 795             hot_y = atoi (gdk_pixbuf_get_option (cursor_pixbuf, "y_hot"));
 796
 797 #if 0
 798           /* The code below is an attempt to let cursor themes
 799            * determine the attachment of the icon to enable things
 800            * like the following:
 801            *
 802            *    +-----+
 803            *    |     |
 804            *    |     ||
 805            *    +-----+|
 806            *        ---+
 807            *
 808            * It does not work since Xcursor doesn't allow to attach
 809            * any additional information to cursors in a retrievable
 810            * way  (there are comments, but no way to get at them
 811            * short of searching for the actual cursor file).
 812            * If this code ever gets used, the icon_window placement
 813            * must be changed to recognize these placement options
 814            * as well. Note that this code ignores info->hot_x/y.
 815            */
 816           for (j = 0; j < 10; j++)
 817             {
 818               const gchar *opt;
 819               gchar key[32];
 820               gchar **toks;
 821               GtkAnchorType icon_anchor;
 822
 823               g_snprintf (key, 32, "comment%d", j);
 824               opt = gdk_pixbuf_get_option (cursor_pixbuf, key);
 825               if (opt && g_str_has_prefix ("icon-attach:", opt))
 826                 {
 827                   toks = g_strsplit (opt + strlen ("icon-attach:"), "'", -1);
 828                   if (g_strv_length (toks) != 3)
 829                     {
 830                       g_strfreev (toks);
 831                       break;
 832                     }
 833                   icon_anchor = atoi (toks[0]);
 834                   icon_x = atoi (toks[1]);
 835                   icon_y = atoi (toks[2]);
 836
 837                   switch (icon_anchor)
 838                     {
 839                     case GTK_ANCHOR_NORTH:
 840                     case GTK_ANCHOR_CENTER:
 841                     case GTK_ANCHOR_SOUTH:
 842                       icon_x += icon_width / 2;
 843                       break;
 844                     case GTK_ANCHOR_NORTH_EAST:
 845                     case GTK_ANCHOR_EAST:
 846                     case GTK_ANCHOR_SOUTH_EAST:
 847                       icon_x += icon_width;
 848                       break;
 849                     default: ;
 850                     }
 851
 852                   switch (icon_anchor)
 853                     {
 854                     case GTK_ANCHOR_WEST:
 855                     case GTK_ANCHOR_CENTER:
 856                     case GTK_ANCHOR_EAST:
 857                       icon_y += icon_height / 2;
 858                       break;
 859                     case GTK_ANCHOR_SOUTH_WEST:
 860                     case GTK_ANCHOR_SOUTH:
 861                     case GTK_ANCHOR_SOUTH_EAST:
 862                       icon_x += icon_height;
 863                       break;
 864                     default: ;
 865                     }
 866
 867                   g_strfreev (toks);
 868                   break;
 869                 }
 870             }
 871 #endif
 872         }
 873
 874       cursor_width = gdk_pixbuf_get_width (cursor_pixbuf);
 875       cursor_height = gdk_pixbuf_get_height (cursor_pixbuf);
 876
 877       ref_x = MAX (hot_x, icon_x);
 878       ref_y = MAX (hot_y, icon_y);
 879       width = ref_x + MAX (cursor_width - hot_x, icon_width - icon_x);
 880       height = ref_y + MAX (cursor_height - hot_y, icon_height - icon_y);
 881
 882       if (gtk_drag_can_use_rgba_cursor (display, width, height))
 883         {
 884           /* Composite cursor and icon so that both hotspots
 885            * end up at (ref_x, ref_y)
 886            */
 887           pixbuf = gdk_pixbuf_new (GDK_COLORSPACE_RGB, TRUE, 8,
 888                                    width, height);
 889
 890           gdk_pixbuf_fill (pixbuf, 0xff000000);
 891
 892           gdk_pixbuf_composite (info->icon_pixbuf, pixbuf,
 893                                 ref_x - icon_x, ref_y - icon_y,
 894                                 icon_width, icon_height,
 895                                 ref_x - icon_x, ref_y - icon_y,
 896                                 1.0, 1.0,
 897                                 GDK_INTERP_BILINEAR, 255);
 898
 899           gdk_pixbuf_composite (cursor_pixbuf, pixbuf,
 900                                 ref_x - hot_x, ref_y - hot_y,
 901                                 cursor_width, cursor_height,
 902                                 ref_x - hot_x, ref_y - hot_y,
 903                                 1.0, 1.0,
 904                                 GDK_INTERP_BILINEAR, 255);
 905
 906           info->drag_cursors[i] =
 907             gdk_cursor_new_from_pixbuf (display, pixbuf, ref_x, ref_y);
 908
 909           g_object_unref (pixbuf);
 910         }
 911
 912       g_object_unref (cursor_pixbuf);
 913
 914       if (info->drag_cursors[i] != NULL)
 915         return info->drag_cursors[i];
 916     }
 917
 918   return drag_cursors[i].cursor;
 919 }
 920
 921 static void
 922 gtk_drag_update_cursor (GtkDragSourceInfo *info)
 923 {
 924   GdkCursor *cursor;
 925   gint i;
 926
 927   if (!info->have_grab)
 928     return;
 929
 930   for (i = 0 ; i < n_drag_cursors - 1; i++)
 931     if (info->cursor == drag_cursors[i].cursor ||
 932         info->cursor == info->drag_cursors[i])
 933       break;
 934
 935   if (i == n_drag_cursors)
 936     return;
 937
 938   cursor = gtk_drag_get_cursor (gdk_cursor_get_display (info->cursor),
 939                                 drag_cursors[i].action, info);
 940
 941   if (cursor != info->cursor)
 942     {
 943       gdk_pointer_grab (info->ipc_widget->window, FALSE,
 944                         GDK_POINTER_MOTION_MASK |
 945                         GDK_BUTTON_RELEASE_MASK,
 946                         NULL,
 947                         cursor, info->grab_time);
 948       info->cursor = cursor;
 949     }
 950 }
 951
 952 /********************
 953  * Destination side *
 954  ********************/
 955
 956 /*************************************************************
 957  * gtk_drag_get_data:
 958  *     Get the data for a drag or drop
 959  *   arguments:
 960  *     context - drag context
 961  *     target  - format to retrieve the data in.
 962  *     time    - timestamp of triggering event.
 963  *
 964  *   results:
 965  *************************************************************/
 966
 967 void
 968 gtk_drag_get_data (GtkWidget      *widget,
 969                    GdkDragContext *context,
 970                    GdkAtom         target,
 971                    guint32         time)
 972 {
 973   GtkWidget *selection_widget;
 974
 975   g_return_if_fail (GTK_IS_WIDGET (widget));
 976   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
 977   g_return_if_fail (!context->is_source);
 978
 979   selection_widget = gtk_drag_get_ipc_widget (widget);
 980
 981   g_object_ref (context);
 982   g_object_ref (widget);
 983
 984   g_signal_connect (selection_widget, "selection-received",
 985                     G_CALLBACK (gtk_drag_selection_received), widget);
 986
 987   g_object_set_data (G_OBJECT (selection_widget), I_("drag-context"), context);
 988
 989   gtk_selection_convert (selection_widget,
 990                          gdk_drag_get_selection (context),
 991                          target,
 992                          time);
 993 }
 994
 995
 996 /*************************************************************
 997  * gtk_drag_get_source_widget:
 998  *     Get the widget the was the source of this drag, if
 999  *     the drag originated from this application.
1000  *   arguments:
1001  *     context: The drag context for this drag
1002  *   results:
1003  *     The source widget, or NULL if the drag originated from
1004  *     a different application.
1005  *************************************************************/
1006
1007 GtkWidget *
1008 gtk_drag_get_source_widget (GdkDragContext *context)
1009 {
1010   GSList *tmp_list;
1011
1012   g_return_val_if_fail (GDK_IS_DRAG_CONTEXT (context), NULL);
1013   g_return_val_if_fail (!context->is_source, NULL);
1014
1015   tmp_list = source_widgets;
1016   while (tmp_list)
1017     {
1018       GtkWidget *ipc_widget = tmp_list->data;
1019
1020       if (ipc_widget->window == context->source_window)
1021         {
1022           GtkDragSourceInfo *info;
1023           info = g_object_get_data (G_OBJECT (ipc_widget), "gtk-info");
1024
1025           return info ? info->widget : NULL;
1026         }
1027
1028       tmp_list = tmp_list->next;
1029     }
1030
1031   return NULL;
1032 }
1033
1034 /*************************************************************
1035  * gtk_drag_finish:
1036  *     Notify the drag source that the transfer of data
1037  *     is complete.
1038  *   arguments:
1039  *     context: The drag context for this drag
1040  *     success: Was the data successfully transferred?
1041  *     time:    The timestamp to use when notifying the destination.
1042  *   results:
1043  *************************************************************/
1044
1045 void
1046 gtk_drag_finish (GdkDragContext *context,
1047                  gboolean        success,
1048                  gboolean        del,
1049                  guint32         time)
1050 {
1051   GdkAtom target = GDK_NONE;
1052
1053   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
1054   g_return_if_fail (!context->is_source);
1055
1056   if (success && del)
1057     {
1058       target = gdk_atom_intern_static_string ("DELETE");
1059     }
1060   else if (context->protocol == GDK_DRAG_PROTO_MOTIF)
1061     {
1062       target = gdk_atom_intern_static_string (success ?
1063                                               "XmTRANSFER_SUCCESS" :
1064                                               "XmTRANSFER_FAILURE");
1065     }
1066
1067   if (target != GDK_NONE)
1068     {
1069       GtkWidget *selection_widget = gtk_drag_get_ipc_widget_for_screen (gdk_drawable_get_screen (context->source_window));
1070
1071       g_object_ref (context);
1072
1073       g_object_set_data (G_OBJECT (selection_widget), I_("drag-context"), context);
1074       g_signal_connect (selection_widget, "selection-received",
1075                         G_CALLBACK (gtk_drag_selection_received),
1076                         NULL);
1077
1078       gtk_selection_convert (selection_widget,
1079                              gdk_drag_get_selection (context),
1080                              target,
1081                              time);
1082     }
1083
1084   if (!(success && del))
1085     gdk_drop_finish (context, success, time);
1086 }
1087
1088 /*************************************************************
1089  * gtk_drag_highlight_expose:
1090  *     Callback for expose_event for highlighted widgets.
1091  *   arguments:
1092  *     widget:
1093  *     event:
1094  *     data:
1095  *   results:
1096  *************************************************************/
1097
1098 static gboolean
1099 gtk_drag_highlight_expose (GtkWidget      *widget,
1100                            GdkEventExpose *event,
1101                            gpointer        data)
1102 {
1103   gint x, y, width, height;
1104
1105   if (GTK_WIDGET_DRAWABLE (widget))
1106     {
1107       cairo_t *cr;
1108
1109       if (!gtk_widget_get_has_window (widget))
1110         {
1111           x = widget->allocation.x;
1112           y = widget->allocation.y;
1113           width = widget->allocation.width;
1114           height = widget->allocation.height;
1115         }
1116       else
1117         {
1118           x = 0;
1119           y = 0;
1120           gdk_drawable_get_size (widget->window, &width, &height);
1121         }
1122
1123       gtk_paint_shadow (widget->style, widget->window,
1124                         GTK_STATE_NORMAL, GTK_SHADOW_OUT,
1125                         &event->area, widget, "dnd",
1126                         x, y, width, height);
1127
1128       cr = gdk_cairo_create (widget->window);
1129       cairo_set_source_rgb (cr, 0.0, 0.0, 0.0); /* black */
1130       cairo_set_line_width (cr, 1.0);
1131       cairo_rectangle (cr,
1132                        x + 0.5, y + 0.5,
1133                        width - 1, height - 1);
1134       cairo_stroke (cr);
1135       cairo_destroy (cr);
1136     }
1137
1138   return FALSE;
1139 }
1140
1141 /*************************************************************
1142  * gtk_drag_highlight:
1143  *     Highlight the given widget in the default manner.
1144  *   arguments:
1145  *     widget:
1146  *   results:
1147  *************************************************************/
1148
1149 void
1150 gtk_drag_highlight (GtkWidget  *widget)
1151 {
1152   g_return_if_fail (GTK_IS_WIDGET (widget));
1153
1154   g_signal_connect_after (widget, "expose-event",
1155                           G_CALLBACK (gtk_drag_highlight_expose),
1156                           NULL);
1157
1158   gtk_widget_queue_draw (widget);
1159 }
1160
1161 /*************************************************************
1162  * gtk_drag_unhighlight:
1163  *     Refresh the given widget to remove the highlight.
1164  *   arguments:
1165  *     widget:
1166  *   results:
1167  *************************************************************/
1168
1169 void
1170 gtk_drag_unhighlight (GtkWidget *widget)
1171 {
1172   g_return_if_fail (GTK_IS_WIDGET (widget));
1173
1174   g_signal_handlers_disconnect_by_func (widget,
1175                                         gtk_drag_highlight_expose,
1176                                         NULL);
1177
1178   gtk_widget_queue_draw (widget);
1179 }
1180
1181 static void
1182 gtk_drag_dest_set_internal (GtkWidget       *widget,
1183                             GtkDragDestSite *site)
1184 {
1185   GtkDragDestSite *old_site;
1186
1187   g_return_if_fail (widget != NULL);
1188
1189   /* HACK, do this in the destroy */
1190   old_site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
1191   if (old_site)
1192     {
1193       g_signal_handlers_disconnect_by_func (widget,
1194                                             gtk_drag_dest_realized,
1195                                             old_site);
1196       g_signal_handlers_disconnect_by_func (widget,
1197                                             gtk_drag_dest_hierarchy_changed,
1198                                             old_site);
1199
1200       site->track_motion = old_site->track_motion;
1201     }
1202
1203   if (GTK_WIDGET_REALIZED (widget))
1204     gtk_drag_dest_realized (widget);
1205
1206   g_signal_connect (widget, "realize",
1207                     G_CALLBACK (gtk_drag_dest_realized), site);
1208   g_signal_connect (widget, "hierarchy-changed",
1209                     G_CALLBACK (gtk_drag_dest_hierarchy_changed), site);
1210
1211   g_object_set_data_full (G_OBJECT (widget), I_("gtk-drag-dest"),
1212                           site, gtk_drag_dest_site_destroy);
1213 }
1214
1215 /**
1216  * gtk_drag_dest_set:
1217  * @widget: a #GtkWidget
1218  * @flags: which types of default drag behavior to use
1219  * @targets: a pointer to an array of #GtkTargetEntry<!-- -->s indicating
1220  * the drop types that this @widget will accept. Later you can access the list
1221  * with gtk_drag_dest_get_target_list() and gtk_drag_dest_find_target().
1222  * @n_targets: the number of entries in @targets.
1223  * @actions: a bitmask of possible actions for a drop onto this @widget.
1224  *
1225  * Sets a widget as a potential drop destination, and adds default behaviors.
1226  *
1227  * The default behaviors listed in @flags have an effect similar
1228  * to installing default handlers for the widget's drag-and-drop signals
1229  * (#GtkWidget:drag-motion, #GtkWidget:drag-drop, ...). They all exist
1230  * for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is
1231  * sufficient to connect to the widget's #GtkWidget::drag-data-received
1232  * signal to get primitive, but consistent drag-and-drop support.
1233  *
1234  * Things become more complicated when you try to preview the dragged data,
1235  * as described in the documentation for #GtkWidget:drag-motion. The default
1236  * behaviors described by @flags make some assumptions, that can conflict
1237  * with your own signal handlers. For instance #GTK_DEST_DEFAULT_DROP causes
1238  * invokations of gdk_drag_status() in the context of #GtkWidget:drag-motion,
1239  * and invokations of gtk_drag_finish() in #GtkWidget:drag-data-received.
1240  * Especially the later is dramatic, when your own #GtkWidget:drag-motion
1241  * handler calls gtk_drag_get_data() to inspect the dragged data.
1242  *
1243  * There's no way to set a default action here, you can use the
1244  * #GtkWidget:drag-motion callback for that. Here's an example which selects
1245  * the action to use depending on whether the control key is pressed or not:
1246  * |[
1247  * static void
1248  * drag_motion (GtkWidget *widget,
1249  *              GdkDragContext *context,
1250  *              gint x,
1251  *              gint y,
1252  *              guint time)
1253  * {
1254  *   GdkModifierType mask;
1255  *
1256  *   gdk_window_get_pointer (gtk_widget_get_window (widget),
1257  *                           NULL, NULL, &mask);
1258  *   if (mask & GDK_CONTROL_MASK)
1259  *     gdk_drag_status (context, GDK_ACTION_COPY, time);
1260  *   else
1261  *     gdk_drag_status (context, GDK_ACTION_MOVE, time);
1262  * }
1263  * ]|
1264  */
1265 void
1266 gtk_drag_dest_set (GtkWidget            *widget,
1267                    GtkDestDefaults       flags,
1268                    const GtkTargetEntry *targets,
1269                    gint                  n_targets,
1270                    GdkDragAction         actions)
1271 {
1272   GtkDragDestSite *site;
1273
1274   g_return_if_fail (GTK_IS_WIDGET (widget));
1275
1276   site = g_new (GtkDragDestSite, 1);
1277
1278   site->flags = flags;
1279   site->have_drag = FALSE;
1280   if (targets)
1281     site->target_list = gtk_target_list_new (targets, n_targets);
1282   else
1283     site->target_list = NULL;
1284   site->actions = actions;
1285   site->do_proxy = FALSE;
1286   site->proxy_window = NULL;
1287   site->track_motion = FALSE;
1288
1289   gtk_drag_dest_set_internal (widget, site);
1290 }
1291
1292 /*************************************************************
1293  * gtk_drag_dest_set_proxy:
1294  *     Set up this widget to proxy drags elsewhere.
1295  *   arguments:
1296  *     widget:
1297  *     proxy_window:    window to which forward drag events
1298  *     protocol:        Drag protocol which the dest widget accepts
1299  *     use_coordinates: If true, send the same coordinates to the
1300  *                      destination, because it is a embedded
1301  *                      subwindow.
1302  *   results:
1303  *************************************************************/
1304
1305 void
1306 gtk_drag_dest_set_proxy (GtkWidget      *widget,
1307                          GdkWindow      *proxy_window,
1308                          GdkDragProtocol protocol,
1309                          gboolean        use_coordinates)
1310 {
1311   GtkDragDestSite *site;
1312
1313   g_return_if_fail (GTK_IS_WIDGET (widget));
1314   g_return_if_fail (!proxy_window || GDK_IS_WINDOW (proxy_window));
1315
1316   site = g_new (GtkDragDestSite, 1);
1317
1318   site->flags = 0;
1319   site->have_drag = FALSE;
1320   site->target_list = NULL;
1321   site->actions = 0;
1322   site->proxy_window = proxy_window;
1323   if (proxy_window)
1324     g_object_ref (proxy_window);
1325   site->do_proxy = TRUE;
1326   site->proxy_protocol = protocol;
1327   site->proxy_coords = use_coordinates;
1328   site->track_motion = FALSE;
1329
1330   gtk_drag_dest_set_internal (widget, site);
1331 }
1332
1333 /*************************************************************
1334  * gtk_drag_dest_unset
1335  *     Unregister this widget as a drag target.
1336  *   arguments:
1337  *     widget:
1338  *   results:
1339  *************************************************************/
1340
1341 void
1342 gtk_drag_dest_unset (GtkWidget *widget)
1343 {
1344   g_return_if_fail (GTK_IS_WIDGET (widget));
1345
1346   g_object_set_data (G_OBJECT (widget), I_("gtk-drag-dest"), NULL);
1347 }
1348
1349 /**
1350  * gtk_drag_dest_get_target_list:
1351  * @widget: a #GtkWidget
1352  *
1353  * Returns the list of targets this widget can accept from
1354  * drag-and-drop.
1355  *
1356  * Return value: the #GtkTargetList, or %NULL if none
1357  **/
1358 GtkTargetList*
1359 gtk_drag_dest_get_target_list (GtkWidget *widget)
1360 {
1361   GtkDragDestSite *site;
1362
1363   g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
1364
1365   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
1366
1367   return site ? site->target_list : NULL;
1368 }
1369
1370 /**
1371  * gtk_drag_dest_set_target_list:
1372  * @widget: a #GtkWidget that's a drag destination
1373  * @target_list: list of droppable targets, or %NULL for none
1374  *
1375  * Sets the target types that this widget can accept from drag-and-drop.
1376  * The widget must first be made into a drag destination with
1377  * gtk_drag_dest_set().
1378  **/
1379 void
1380 gtk_drag_dest_set_target_list (GtkWidget      *widget,
1381                                GtkTargetList  *target_list)
1382 {
1383   GtkDragDestSite *site;
1384
1385   g_return_if_fail (GTK_IS_WIDGET (widget));
1386
1387   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
1388
1389   if (!site)
1390     {
1391       g_warning ("Can't set a target list on a widget until you've called gtk_drag_dest_set() "
1392                  "to make the widget into a drag destination");
1393       return;
1394     }
1395
1396   if (target_list)
1397     gtk_target_list_ref (target_list);
1398
1399   if (site->target_list)
1400     gtk_target_list_unref (site->target_list);
1401
1402   site->target_list = target_list;
1403 }
1404
1405 /**
1406  * gtk_drag_dest_add_text_targets:
1407  * @widget: a #GtkWidget that's a drag destination
1408  *
1409  * Add the text targets supported by #GtkSelection to
1410  * the target list of the drag destination. The targets
1411  * are added with @info = 0. If you need another value,
1412  * use gtk_target_list_add_text_targets() and
1413  * gtk_drag_dest_set_target_list().
1414  *
1415  * Since: 2.6
1416  **/
1417 void
1418 gtk_drag_dest_add_text_targets (GtkWidget *widget)
1419 {
1420   GtkTargetList *target_list;
1421
1422   target_list = gtk_drag_dest_get_target_list (widget);
1423   if (target_list)
1424     gtk_target_list_ref (target_list);
1425   else
1426     target_list = gtk_target_list_new (NULL, 0);
1427   gtk_target_list_add_text_targets (target_list, 0);
1428   gtk_drag_dest_set_target_list (widget, target_list);
1429   gtk_target_list_unref (target_list);
1430 }
1431
1432 /**
1433  * gtk_drag_dest_add_image_targets:
1434  * @widget: a #GtkWidget that's a drag destination
1435  *
1436  * Add the image targets supported by #GtkSelection to
1437  * the target list of the drag destination. The targets
1438  * are added with @info = 0. If you need another value,
1439  * use gtk_target_list_add_image_targets() and
1440  * gtk_drag_dest_set_target_list().
1441  *
1442  * Since: 2.6
1443  **/
1444 void
1445 gtk_drag_dest_add_image_targets (GtkWidget *widget)
1446 {
1447   GtkTargetList *target_list;
1448
1449   target_list = gtk_drag_dest_get_target_list (widget);
1450   if (target_list)
1451     gtk_target_list_ref (target_list);
1452   else
1453     target_list = gtk_target_list_new (NULL, 0);
1454   gtk_target_list_add_image_targets (target_list, 0, FALSE);
1455   gtk_drag_dest_set_target_list (widget, target_list);
1456   gtk_target_list_unref (target_list);
1457 }
1458
1459 /**
1460  * gtk_drag_dest_add_uri_targets:
1461  * @widget: a #GtkWidget that's a drag destination
1462  *
1463  * Add the URI targets supported by #GtkSelection to
1464  * the target list of the drag destination. The targets
1465  * are added with @info = 0. If you need another value,
1466  * use gtk_target_list_add_uri_targets() and
1467  * gtk_drag_dest_set_target_list().
1468  *
1469  * Since: 2.6
1470  **/
1471 void
1472 gtk_drag_dest_add_uri_targets (GtkWidget *widget)
1473 {
1474   GtkTargetList *target_list;
1475
1476   target_list = gtk_drag_dest_get_target_list (widget);
1477   if (target_list)
1478     gtk_target_list_ref (target_list);
1479   else
1480     target_list = gtk_target_list_new (NULL, 0);
1481   gtk_target_list_add_uri_targets (target_list, 0);
1482   gtk_drag_dest_set_target_list (widget, target_list);
1483   gtk_target_list_unref (target_list);
1484 }
1485
1486 /**
1487  * gtk_drag_dest_set_track_motion:
1488  * @widget: a #GtkWidget that's a drag destination
1489  * @track_motion: whether to accept all targets
1490  *
1491  * Tells the widget to emit ::drag-motion and ::drag-leave
1492  * events regardless of the targets and the %GTK_DEST_DEFAULT_MOTION
1493  * flag.
1494  *
1495  * This may be used when a widget wants to do generic
1496  * actions regardless of the targets that the source offers.
1497  *
1498  * Since: 2.10
1499  **/
1500 void
1501 gtk_drag_dest_set_track_motion (GtkWidget *widget,
1502                                 gboolean   track_motion)
1503 {
1504   GtkDragDestSite *site;
1505
1506   g_return_if_fail (GTK_IS_WIDGET (widget));
1507
1508   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
1509
1510   g_return_if_fail (site != NULL);
1511
1512   site->track_motion = track_motion != FALSE;
1513 }
1514
1515 /**
1516  * gtk_drag_dest_get_track_motion:
1517  * @widget: a #GtkWidget that's a drag destination
1518  *
1519  * Returns whether the widget has been configured to always
1520  * emit ::drag-motion signals.
1521  *
1522  * Return Value: %TRUE if the widget always emits ::drag-motion events
1523  *
1524  * Since: 2.10
1525  **/
1526 gboolean
1527 gtk_drag_dest_get_track_motion (GtkWidget *widget)
1528 {
1529   GtkDragDestSite *site;
1530
1531   g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
1532
1533   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
1534
1535   if (site)
1536     return site->track_motion;
1537
1538   return FALSE;
1539 }
1540
1541 /*************************************************************
1542  * _gtk_drag_dest_handle_event:
1543  *     Called from widget event handling code on Drag events
1544  *     for destinations.
1545  *
1546  *   arguments:
1547  *     toplevel: Toplevel widget that received the event
1548  *     event:
1549  *   results:
1550  *************************************************************/
1551
1552 void
1553 _gtk_drag_dest_handle_event (GtkWidget *toplevel,
1554                             GdkEvent  *event)
1555 {
1556   GtkDragDestInfo *info;
1557   GdkDragContext *context;
1558
1559   g_return_if_fail (toplevel != NULL);
1560   g_return_if_fail (event != NULL);
1561
1562   context = event->dnd.context;
1563
1564   info = gtk_drag_get_dest_info (context, TRUE);
1565
1566   /* Find the widget for the event */
1567   switch (event->type)
1568     {
1569     case GDK_DRAG_ENTER:
1570       break;
1571
1572     case GDK_DRAG_LEAVE:
1573       if (info->widget)
1574         {
1575           gtk_drag_dest_leave (info->widget, context, event->dnd.time);
1576           info->widget = NULL;
1577         }
1578       break;
1579
1580     case GDK_DRAG_MOTION:
1581     case GDK_DROP_START:
1582       {
1583         GtkDragFindData data;
1584         gint tx, ty;
1585
1586         if (event->type == GDK_DROP_START)
1587           {
1588             info->dropped = TRUE;
1589             /* We send a leave here so that the widget unhighlights
1590              * properly.
1591              */
1592             if (info->widget)
1593               {
1594                 gtk_drag_dest_leave (info->widget, context, event->dnd.time);
1595                 info->widget = NULL;
1596               }
1597           }
1598
1599 #ifdef GDK_WINDOWING_X11
1600         /* Hackaround for: http://bugzilla.gnome.org/show_bug.cgi?id=136112
1601          *
1602          * Currently gdk_window_get_position doesn't provide reliable
1603          * information for embedded windows, so we call the much more
1604          * expensive gdk_window_get_origin().
1605          */
1606         if (GTK_IS_PLUG (toplevel))
1607           gdk_window_get_origin (toplevel->window, &tx, &ty);
1608         else
1609 #endif /* GDK_WINDOWING_X11 */
1610           gdk_window_get_position (toplevel->window, &tx, &ty);
1611
1612         data.x = event->dnd.x_root - tx;
1613         data.y = event->dnd.y_root - ty;
1614         data.context = context;
1615         data.info = info;
1616         data.found = FALSE;
1617         data.toplevel = TRUE;
1618         data.callback = (event->type == GDK_DRAG_MOTION) ?
1619           gtk_drag_dest_motion : gtk_drag_dest_drop;
1620         data.time = event->dnd.time;
1621
1622         gtk_drag_find_widget (toplevel, &data);
1623
1624         if (info->widget && !data.found)
1625           {
1626             gtk_drag_dest_leave (info->widget, context, event->dnd.time);
1627             info->widget = NULL;
1628           }
1629
1630         /* Send a reply.
1631          */
1632         if (event->type == GDK_DRAG_MOTION)
1633           {
1634             if (!data.found)
1635               gdk_drag_status (context, 0, event->dnd.time);
1636           }
1637         else if (event->type == GDK_DROP_START && !info->proxy_source)
1638           {
1639             gdk_drop_reply (context, data.found, event->dnd.time);
1640             if ((context->protocol == GDK_DRAG_PROTO_MOTIF) && !data.found)
1641               gtk_drag_finish (context, FALSE, FALSE, event->dnd.time);
1642           }
1643       }
1644       break;
1645
1646     default:
1647       g_assert_not_reached ();
1648     }
1649 }
1650
1651 /**
1652  * gtk_drag_dest_find_target:
1653  * @widget: drag destination widget
1654  * @context: drag context
1655  * @target_list: list of droppable targets, or %NULL to use
1656  *    gtk_drag_dest_get_target_list (@widget).
1657  *
1658  * Looks for a match between @context->targets and the
1659  * @dest_target_list, returning the first matching target, otherwise
1660  * returning %GDK_NONE. @dest_target_list should usually be the return
1661  * value from gtk_drag_dest_get_target_list(), but some widgets may
1662  * have different valid targets for different parts of the widget; in
1663  * that case, they will have to implement a drag_motion handler that
1664  * passes the correct target list to this function.
1665  *
1666  * Return value: first target that the source offers and the dest can accept, or %GDK_NONE
1667  **/
1668 GdkAtom
1669 gtk_drag_dest_find_target (GtkWidget      *widget,
1670                            GdkDragContext *context,
1671                            GtkTargetList  *target_list)
1672 {
1673   GList *tmp_target;
1674   GList *tmp_source = NULL;
1675   GtkWidget *source_widget;
1676
1677   g_return_val_if_fail (GTK_IS_WIDGET (widget), GDK_NONE);
1678   g_return_val_if_fail (GDK_IS_DRAG_CONTEXT (context), GDK_NONE);
1679   g_return_val_if_fail (!context->is_source, GDK_NONE);
1680
1681
1682   source_widget = gtk_drag_get_source_widget (context);
1683
1684   if (target_list == NULL)
1685     target_list = gtk_drag_dest_get_target_list (widget);
1686
1687   if (target_list == NULL)
1688     return GDK_NONE;
1689
1690   tmp_target = target_list->list;
1691   while (tmp_target)
1692     {
1693       GtkTargetPair *pair = tmp_target->data;
1694       tmp_source = context->targets;
1695       while (tmp_source)
1696         {
1697           if (tmp_source->data == GUINT_TO_POINTER (pair->target))
1698             {
1699               if ((!(pair->flags & GTK_TARGET_SAME_APP) || source_widget) &&
1700                   (!(pair->flags & GTK_TARGET_SAME_WIDGET) || (source_widget == widget)) &&
1701                   (!(pair->flags & GTK_TARGET_OTHER_APP) || !source_widget) &&
1702                   (!(pair->flags & GTK_TARGET_OTHER_WIDGET) || (source_widget != widget)))
1703                 return pair->target;
1704               else
1705                 break;
1706             }
1707           tmp_source = tmp_source->next;
1708         }
1709       tmp_target = tmp_target->next;
1710     }
1711
1712   return GDK_NONE;
1713 }
1714
1715 static void
1716 gtk_drag_selection_received (GtkWidget        *widget,
1717                              GtkSelectionData *selection_data,
1718                              guint             time,
1719                              gpointer          data)
1720 {
1721   GdkDragContext *context;
1722   GtkDragDestInfo *info;
1723   GtkWidget *drop_widget;
1724
1725   drop_widget = data;
1726
1727   context = g_object_get_data (G_OBJECT (widget), "drag-context");
1728   info = gtk_drag_get_dest_info (context, FALSE);
1729
1730   if (info->proxy_data &&
1731       info->proxy_data->target == selection_data->target)
1732     {
1733       gtk_selection_data_set (info->proxy_data,
1734                               selection_data->type,
1735                               selection_data->format,
1736                               selection_data->data,
1737                               selection_data->length);
1738       gtk_main_quit ();
1739       return;
1740     }
1741
1742   if (selection_data->target == gdk_atom_intern_static_string ("DELETE"))
1743     {
1744       gtk_drag_finish (context, TRUE, FALSE, time);
1745     }
1746   else if ((selection_data->target == gdk_atom_intern_static_string ("XmTRANSFER_SUCCESS")) ||
1747            (selection_data->target == gdk_atom_intern_static_string ("XmTRANSFER_FAILURE")))
1748     {
1749       /* Do nothing */
1750     }
1751   else
1752     {
1753       GtkDragDestSite *site;
1754
1755       site = g_object_get_data (G_OBJECT (drop_widget), "gtk-drag-dest");
1756
1757       if (site && site->target_list)
1758         {
1759           guint target_info;
1760
1761           if (gtk_target_list_find (site->target_list,
1762                                     selection_data->target,
1763                                     &target_info))
1764             {
1765               if (!(site->flags & GTK_DEST_DEFAULT_DROP) ||
1766                   selection_data->length >= 0)
1767                 g_signal_emit_by_name (drop_widget,
1768                                        "drag-data-received",
1769                                        context, info->drop_x, info->drop_y,
1770                                        selection_data,
1771                                        target_info, time);
1772             }
1773         }
1774       else
1775         {
1776           g_signal_emit_by_name (drop_widget,
1777                                  "drag-data-received",
1778                                  context, info->drop_x, info->drop_y,
1779                                  selection_data,
1780                                  0, time);
1781         }
1782
1783       if (site && site->flags & GTK_DEST_DEFAULT_DROP)
1784         {
1785
1786           gtk_drag_finish (context,
1787                            (selection_data->length >= 0),
1788                            (context->action == GDK_ACTION_MOVE),
1789                            time);
1790         }
1791
1792       g_object_unref (drop_widget);
1793     }
1794
1795   g_signal_handlers_disconnect_by_func (widget,
1796                                         gtk_drag_selection_received,
1797                                         data);
1798
1799   g_object_set_data (G_OBJECT (widget), I_("drag-context"), NULL);
1800   g_object_unref (context);
1801
1802   gtk_drag_release_ipc_widget (widget);
1803 }
1804
1805 static void
1806 prepend_and_ref_widget (GtkWidget *widget,
1807                         gpointer   data)
1808 {
1809   GSList **slist_p = data;
1810
1811   *slist_p = g_slist_prepend (*slist_p, g_object_ref (widget));
1812 }
1813
1814 /*************************************************************
1815  * gtk_drag_find_widget:
1816  *     Recursive callback used to locate widgets for
1817  *     DRAG_MOTION and DROP_START events.
1818  *   arguments:
1819  *
1820  *   results:
1821  *************************************************************/
1822
1823 static void
1824 gtk_drag_find_widget (GtkWidget       *widget,
1825                       GtkDragFindData *data)
1826 {
1827   GtkAllocation new_allocation;
1828   gint allocation_to_window_x = 0;
1829   gint allocation_to_window_y = 0;
1830   gint x_offset = 0;
1831   gint y_offset = 0;
1832
1833   if (data->found || !GTK_WIDGET_MAPPED (widget) || !GTK_WIDGET_SENSITIVE (widget))
1834     return;
1835
1836   /* Note that in the following code, we only count the
1837    * position as being inside a WINDOW widget if it is inside
1838    * widget->window; points that are outside of widget->window
1839    * but within the allocation are not counted. This is consistent
1840    * with the way we highlight drag targets.
1841    *
1842    * data->x,y are relative to widget->parent->window (if
1843    * widget is not a toplevel, widget->window otherwise).
1844    * We compute the allocation of widget in the same coordinates,
1845    * clipping to widget->window, and all intermediate
1846    * windows. If data->x,y is inside that, then we translate
1847    * our coordinates to be relative to widget->window and
1848    * recurse.
1849    */
1850   new_allocation = widget->allocation;
1851
1852   if (widget->parent)
1853     {
1854       gint tx, ty;
1855       GdkWindow *window = widget->window;
1856
1857       /* Compute the offset from allocation-relative to
1858        * window-relative coordinates.
1859        */
1860       allocation_to_window_x = widget->allocation.x;
1861       allocation_to_window_y = widget->allocation.y;
1862
1863       if (gtk_widget_get_has_window (widget))
1864         {
1865           /* The allocation is relative to the parent window for
1866            * window widgets, not to widget->window.
1867            */
1868           gdk_window_get_position (window, &tx, &ty);
1869
1870           allocation_to_window_x -= tx;
1871           allocation_to_window_y -= ty;
1872         }
1873
1874       new_allocation.x = 0 + allocation_to_window_x;
1875       new_allocation.y = 0 + allocation_to_window_y;
1876
1877       while (window && window != widget->parent->window)
1878         {
1879           GdkRectangle window_rect = { 0, 0, 0, 0 };
1880
1881           gdk_drawable_get_size (window, &window_rect.width, &window_rect.height);
1882
1883           gdk_rectangle_intersect (&new_allocation, &window_rect, &new_allocation);
1884
1885           gdk_window_get_position (window, &tx, &ty);
1886           new_allocation.x += tx;
1887           x_offset += tx;
1888           new_allocation.y += ty;
1889           y_offset += ty;
1890
1891           window = gdk_window_get_parent (window);
1892         }
1893
1894       if (!window)              /* Window and widget heirarchies didn't match. */
1895         return;
1896     }
1897
1898   if (data->toplevel ||
1899       ((data->x >= new_allocation.x) && (data->y >= new_allocation.y) &&
1900        (data->x < new_allocation.x + new_allocation.width) &&
1901        (data->y < new_allocation.y + new_allocation.height)))
1902     {
1903       /* First, check if the drag is in a valid drop site in
1904        * one of our children
1905        */
1906       if (GTK_IS_CONTAINER (widget))
1907         {
1908           GtkDragFindData new_data = *data;
1909           GSList *children = NULL;
1910           GSList *tmp_list;
1911
1912           new_data.x -= x_offset;
1913           new_data.y -= y_offset;
1914           new_data.found = FALSE;
1915           new_data.toplevel = FALSE;
1916
1917           /* need to reference children temporarily in case the
1918            * ::drag-motion/::drag-drop callbacks change the widget hierarchy.
1919            */
1920           gtk_container_forall (GTK_CONTAINER (widget), prepend_and_ref_widget, &children);
1921           for (tmp_list = children; tmp_list; tmp_list = tmp_list->next)
1922             {
1923               if (!new_data.found && GTK_WIDGET_DRAWABLE (tmp_list->data))
1924                 gtk_drag_find_widget (tmp_list->data, &new_data);
1925               g_object_unref (tmp_list->data);
1926             }
1927           g_slist_free (children);
1928
1929           data->found = new_data.found;
1930         }
1931
1932       /* If not, and this widget is registered as a drop site, check to
1933        * emit "drag-motion" to check if we are actually in
1934        * a drop site.
1935        */
1936       if (!data->found &&
1937           g_object_get_data (G_OBJECT (widget), "gtk-drag-dest"))
1938         {
1939           data->found = data->callback (widget,
1940                                         data->context,
1941                                         data->x - x_offset - allocation_to_window_x,
1942                                         data->y - y_offset - allocation_to_window_y,
1943                                         data->time);
1944           /* If so, send a "drag-leave" to the last widget */
1945           if (data->found)
1946             {
1947               if (data->info->widget && data->info->widget != widget)
1948                 {
1949                   gtk_drag_dest_leave (data->info->widget, data->context, data->time);
1950                 }
1951               data->info->widget = widget;
1952             }
1953         }
1954     }
1955 }
1956
1957 static void
1958 gtk_drag_proxy_begin (GtkWidget       *widget,
1959                       GtkDragDestInfo *dest_info,
1960                       guint32          time)
1961 {
1962   GtkDragSourceInfo *source_info;
1963   GList *tmp_list;
1964   GdkDragContext *context;
1965   GtkWidget *ipc_widget;
1966
1967   if (dest_info->proxy_source)
1968     {
1969       gdk_drag_abort (dest_info->proxy_source->context, time);
1970       gtk_drag_source_info_destroy (dest_info->proxy_source);
1971       dest_info->proxy_source = NULL;
1972     }
1973
1974   ipc_widget = gtk_drag_get_ipc_widget (widget);
1975   context = gdk_drag_begin (ipc_widget->window,
1976                             dest_info->context->targets);
1977
1978   source_info = gtk_drag_get_source_info (context, TRUE);
1979
1980   source_info->ipc_widget = ipc_widget;
1981   source_info->widget = g_object_ref (widget);
1982
1983   source_info->target_list = gtk_target_list_new (NULL, 0);
1984   tmp_list = dest_info->context->targets;
1985   while (tmp_list)
1986     {
1987       gtk_target_list_add (source_info->target_list,
1988                            GDK_POINTER_TO_ATOM (tmp_list->data), 0, 0);
1989       tmp_list = tmp_list->next;
1990     }
1991
1992   source_info->proxy_dest = dest_info;
1993
1994   g_signal_connect (ipc_widget,
1995                     "selection-get",
1996                     G_CALLBACK (gtk_drag_selection_get),
1997                     source_info);
1998
1999   dest_info->proxy_source = source_info;
2000 }
2001
2002 static void
2003 gtk_drag_dest_info_destroy (gpointer data)
2004 {
2005   GtkDragDestInfo *info = data;
2006
2007   g_free (info);
2008 }
2009
2010 static GtkDragDestInfo *
2011 gtk_drag_get_dest_info (GdkDragContext *context,
2012                         gboolean        create)
2013 {
2014   GtkDragDestInfo *info;
2015   static GQuark info_quark = 0;
2016   if (!info_quark)
2017     info_quark = g_quark_from_static_string ("gtk-dest-info");
2018
2019   info = g_object_get_qdata (G_OBJECT (context), info_quark);
2020   if (!info && create)
2021     {
2022       info = g_new (GtkDragDestInfo, 1);
2023       info->widget = NULL;
2024       info->context = context;
2025       info->proxy_source = NULL;
2026       info->proxy_data = NULL;
2027       info->dropped = FALSE;
2028       info->proxy_drop_wait = FALSE;
2029       g_object_set_qdata_full (G_OBJECT (context), info_quark,
2030                                info, gtk_drag_dest_info_destroy);
2031     }
2032
2033   return info;
2034 }
2035
2036 static GQuark dest_info_quark = 0;
2037
2038 static GtkDragSourceInfo *
2039 gtk_drag_get_source_info (GdkDragContext *context,
2040                           gboolean        create)
2041 {
2042   GtkDragSourceInfo *info;
2043   if (!dest_info_quark)
2044     dest_info_quark = g_quark_from_static_string ("gtk-source-info");
2045
2046   info = g_object_get_qdata (G_OBJECT (context), dest_info_quark);
2047   if (!info && create)
2048     {
2049       info = g_new0 (GtkDragSourceInfo, 1);
2050       info->context = context;
2051       g_object_set_qdata (G_OBJECT (context), dest_info_quark, info);
2052     }
2053
2054   return info;
2055 }
2056
2057 static void
2058 gtk_drag_clear_source_info (GdkDragContext *context)
2059 {
2060   g_object_set_qdata (G_OBJECT (context), dest_info_quark, NULL);
2061 }
2062
2063 static void
2064 gtk_drag_dest_realized (GtkWidget *widget)
2065 {
2066   GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
2067
2068   if (gtk_widget_is_toplevel (toplevel))
2069     gdk_window_register_dnd (toplevel->window);
2070 }
2071
2072 static void
2073 gtk_drag_dest_hierarchy_changed (GtkWidget *widget,
2074                                  GtkWidget *previous_toplevel)
2075 {
2076   GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
2077
2078   if (gtk_widget_is_toplevel (toplevel) && GTK_WIDGET_REALIZED (toplevel))
2079     gdk_window_register_dnd (toplevel->window);
2080 }
2081
2082 static void
2083 gtk_drag_dest_site_destroy (gpointer data)
2084 {
2085   GtkDragDestSite *site = data;
2086
2087   if (site->proxy_window)
2088     g_object_unref (site->proxy_window);
2089
2090   if (site->target_list)
2091     gtk_target_list_unref (site->target_list);
2092
2093   g_free (site);
2094 }
2095
2096 /*
2097  * Default drag handlers
2098  */
2099 static void
2100 gtk_drag_dest_leave (GtkWidget      *widget,
2101                      GdkDragContext *context,
2102                      guint           time)
2103 {
2104   GtkDragDestSite *site;
2105
2106   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
2107   g_return_if_fail (site != NULL);
2108
2109   if (site->do_proxy)
2110     {
2111       GtkDragDestInfo *info = gtk_drag_get_dest_info (context, FALSE);
2112
2113       if (info->proxy_source && info->proxy_source->widget == widget && !info->dropped)
2114         {
2115           gdk_drag_abort (info->proxy_source->context, time);
2116           gtk_drag_source_info_destroy (info->proxy_source);
2117           info->proxy_source = NULL;
2118         }
2119
2120       return;
2121     }
2122   else
2123     {
2124       if ((site->flags & GTK_DEST_DEFAULT_HIGHLIGHT) && site->have_drag)
2125         gtk_drag_unhighlight (widget);
2126
2127       if (!(site->flags & GTK_DEST_DEFAULT_MOTION) || site->have_drag ||
2128           site->track_motion)
2129         g_signal_emit_by_name (widget, "drag-leave", context, time);
2130
2131       site->have_drag = FALSE;
2132     }
2133 }
2134
2135 static gboolean
2136 gtk_drag_dest_motion (GtkWidget      *widget,
2137                       GdkDragContext *context,
2138                       gint            x,
2139                       gint            y,
2140                       guint           time)
2141 {
2142   GtkDragDestSite *site;
2143   GdkDragAction action = 0;
2144   gboolean retval;
2145
2146   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
2147   g_return_val_if_fail (site != NULL, FALSE);
2148
2149   if (site->do_proxy)
2150     {
2151       GdkAtom selection;
2152       GdkEvent *current_event;
2153       GdkWindow *dest_window;
2154       GdkDragProtocol proto;
2155
2156       GtkDragDestInfo *info = gtk_drag_get_dest_info (context, FALSE);
2157
2158       if (!info->proxy_source || info->proxy_source->widget != widget)
2159         gtk_drag_proxy_begin (widget, info, time);
2160
2161       current_event = gtk_get_current_event ();
2162
2163       if (site->proxy_window)
2164         {
2165           dest_window = site->proxy_window;
2166           proto = site->proxy_protocol;
2167         }
2168       else
2169         {
2170           gdk_drag_find_window_for_screen (info->proxy_source->context,
2171                                            NULL,
2172                                            gdk_drawable_get_screen (current_event->dnd.window),
2173                                            current_event->dnd.x_root,
2174                                            current_event->dnd.y_root,
2175                                            &dest_window, &proto);
2176         }
2177
2178       gdk_drag_motion (info->proxy_source->context,
2179                        dest_window, proto,
2180                        current_event->dnd.x_root,
2181                        current_event->dnd.y_root,
2182                        context->suggested_action,
2183                        context->actions, time);
2184
2185       if (!site->proxy_window && dest_window)
2186         g_object_unref (dest_window);
2187
2188       selection = gdk_drag_get_selection (info->proxy_source->context);
2189       if (selection &&
2190           selection != gdk_drag_get_selection (info->context))
2191         gtk_drag_source_check_selection (info->proxy_source, selection, time);
2192
2193       gdk_event_free (current_event);
2194
2195       return TRUE;
2196     }
2197
2198   if (site->track_motion || site->flags & GTK_DEST_DEFAULT_MOTION)
2199     {
2200       if (context->suggested_action & site->actions)
2201         action = context->suggested_action;
2202       else
2203         {
2204           gint i;
2205
2206           for (i = 0; i < 8; i++)
2207             {
2208               if ((site->actions & (1 << i)) &&
2209                   (context->actions & (1 << i)))
2210                 {
2211                   action = (1 << i);
2212                   break;
2213                 }
2214             }
2215         }
2216
2217       if (action && gtk_drag_dest_find_target (widget, context, NULL))
2218         {
2219           if (!site->have_drag)
2220             {
2221               site->have_drag = TRUE;
2222               if (site->flags & GTK_DEST_DEFAULT_HIGHLIGHT)
2223                 gtk_drag_highlight (widget);
2224             }
2225
2226           gdk_drag_status (context, action, time);
2227         }
2228       else
2229         {
2230           gdk_drag_status (context, 0, time);
2231           if (!site->track_motion)
2232             return TRUE;
2233         }
2234     }
2235
2236   g_signal_emit_by_name (widget, "drag-motion",
2237                          context, x, y, time, &retval);
2238
2239   return (site->flags & GTK_DEST_DEFAULT_MOTION) ? TRUE : retval;
2240 }
2241
2242 static gboolean
2243 gtk_drag_dest_drop (GtkWidget        *widget,
2244                     GdkDragContext   *context,
2245                     gint              x,
2246                     gint              y,
2247                     guint             time)
2248 {
2249   GtkDragDestSite *site;
2250   GtkDragDestInfo *info;
2251
2252   site = g_object_get_data (G_OBJECT (widget), "gtk-drag-dest");
2253   g_return_val_if_fail (site != NULL, FALSE);
2254
2255   info = gtk_drag_get_dest_info (context, FALSE);
2256   g_return_val_if_fail (info != NULL, FALSE);
2257
2258   info->drop_x = x;
2259   info->drop_y = y;
2260
2261   if (site->do_proxy)
2262     {
2263       if (info->proxy_source ||
2264           (info->context->protocol == GDK_DRAG_PROTO_ROOTWIN))
2265         {
2266           gtk_drag_drop (info->proxy_source, time);
2267         }
2268       else
2269         {
2270           /* We need to synthesize a motion event, wait for a status,
2271            * and, if we get a good one, do a drop.
2272            */
2273
2274           GdkEvent *current_event;
2275           GdkAtom selection;
2276           GdkWindow *dest_window;
2277           GdkDragProtocol proto;
2278
2279           gtk_drag_proxy_begin (widget, info, time);
2280           info->proxy_drop_wait = TRUE;
2281           info->proxy_drop_time = time;
2282
2283           current_event = gtk_get_current_event ();
2284
2285           if (site->proxy_window)
2286             {
2287               dest_window = site->proxy_window;
2288               proto = site->proxy_protocol;
2289             }
2290           else
2291             {
2292               gdk_drag_find_window_for_screen (info->proxy_source->context,
2293                                                NULL,
2294                                                gdk_drawable_get_screen (current_event->dnd.window),
2295                                                current_event->dnd.x_root,
2296                                                current_event->dnd.y_root,
2297                                                &dest_window, &proto);
2298             }
2299
2300           gdk_drag_motion (info->proxy_source->context,
2301                            dest_window, proto,
2302                            current_event->dnd.x_root,
2303                            current_event->dnd.y_root,
2304                            context->suggested_action,
2305                            context->actions, time);
2306
2307           if (!site->proxy_window && dest_window)
2308             g_object_unref (dest_window);
2309
2310           selection = gdk_drag_get_selection (info->proxy_source->context);
2311           if (selection &&
2312               selection != gdk_drag_get_selection (info->context))
2313             gtk_drag_source_check_selection (info->proxy_source, selection, time);
2314
2315           gdk_event_free (current_event);
2316         }
2317
2318       return TRUE;
2319     }
2320   else
2321     {
2322       gboolean retval;
2323
2324       if (site->flags & GTK_DEST_DEFAULT_DROP)
2325         {
2326           GdkAtom target = gtk_drag_dest_find_target (widget, context, NULL);
2327
2328           if (target == GDK_NONE)
2329             {
2330               gtk_drag_finish (context, FALSE, FALSE, time);
2331               return TRUE;
2332             }
2333           else
2334             gtk_drag_get_data (widget, context, target, time);
2335         }
2336
2337       g_signal_emit_by_name (widget, "drag-drop",
2338                              context, x, y, time, &retval);
2339
2340       return (site->flags & GTK_DEST_DEFAULT_DROP) ? TRUE : retval;
2341     }
2342 }
2343
2344 /***************
2345  * Source side *
2346  ***************/
2347
2348 /* Like GtkDragBegin, but also takes a GtkDragSourceSite,
2349  * so that we can set the icon from the source site information
2350  */
2351 static GdkDragContext *
2352 gtk_drag_begin_internal (GtkWidget         *widget,
2353                          GtkDragSourceSite *site,
2354                          GtkTargetList     *target_list,
2355                          GdkDragAction      actions,
2356                          gint               button,
2357                          GdkEvent          *event)
2358 {
2359   GtkDragSourceInfo *info;
2360   GList *targets = NULL;
2361   GList *tmp_list;
2362   guint32 time = GDK_CURRENT_TIME;
2363   GdkDragAction possible_actions, suggested_action;
2364   GdkDragContext *context;
2365   GtkWidget *ipc_widget;
2366   GdkCursor *cursor;
2367
2368   ipc_widget = gtk_drag_get_ipc_widget (widget);
2369
2370   gtk_drag_get_event_actions (event, button, actions,
2371                               &suggested_action, &possible_actions);
2372
2373   cursor = gtk_drag_get_cursor (gtk_widget_get_display (widget),
2374                                 suggested_action,
2375                                 NULL);
2376
2377   if (event)
2378     time = gdk_event_get_time (event);
2379
2380   if (gdk_pointer_grab (ipc_widget->window, FALSE,
2381                         GDK_POINTER_MOTION_MASK |
2382                         GDK_BUTTON_RELEASE_MASK, NULL,
2383                         cursor, time) != GDK_GRAB_SUCCESS)
2384     {
2385       gtk_drag_release_ipc_widget (ipc_widget);
2386       return NULL;
2387     }
2388
2389   grab_dnd_keys (ipc_widget, time);
2390
2391   /* We use a GTK grab here to override any grabs that the widget
2392    * we are dragging from might have held
2393    */
2394   gtk_grab_add (ipc_widget);
2395
2396   tmp_list = g_list_last (target_list->list);
2397   while (tmp_list)
2398     {
2399       GtkTargetPair *pair = tmp_list->data;
2400       targets = g_list_prepend (targets,
2401                                 GINT_TO_POINTER (pair->target));
2402       tmp_list = tmp_list->prev;
2403     }
2404
2405   source_widgets = g_slist_prepend (source_widgets, ipc_widget);
2406
2407   context = gdk_drag_begin (ipc_widget->window, targets);
2408   g_list_free (targets);
2409
2410   info = gtk_drag_get_source_info (context, TRUE);
2411
2412   info->ipc_widget = ipc_widget;
2413   g_object_set_data (G_OBJECT (info->ipc_widget), I_("gtk-info"), info);
2414
2415   info->widget = g_object_ref (widget);
2416
2417   info->button = button;
2418   info->cursor = cursor;
2419   info->target_list = target_list;
2420   gtk_target_list_ref (target_list);
2421
2422   info->possible_actions = actions;
2423
2424   info->status = GTK_DRAG_STATUS_DRAG;
2425   info->last_event = NULL;
2426   info->selections = NULL;
2427   info->icon_window = NULL;
2428   info->destroy_icon = FALSE;
2429
2430   /* Set cur_x, cur_y here so if the "drag-begin" signal shows
2431    * the drag icon, it will be in the right place
2432    */
2433   if (event && event->type == GDK_MOTION_NOTIFY)
2434     {
2435       info->cur_screen = gtk_widget_get_screen (widget);
2436       info->cur_x = event->motion.x_root;
2437       info->cur_y = event->motion.y_root;
2438     }
2439   else
2440     {
2441       gdk_display_get_pointer (gtk_widget_get_display (widget),
2442                                &info->cur_screen, &info->cur_x, &info->cur_y, NULL);
2443     }
2444
2445   g_signal_emit_by_name (widget, "drag-begin", info->context);
2446
2447   /* Ensure that we have an icon before we start the drag; the
2448    * application may have set one in ::drag_begin, or it may
2449    * not have set one.
2450    */
2451   if (!info->icon_window && !info->icon_pixbuf)
2452     {
2453       if (!site || site->icon_type == GTK_IMAGE_EMPTY)
2454         gtk_drag_set_icon_default (context);
2455       else
2456         switch (site->icon_type)
2457           {
2458           case GTK_IMAGE_PIXMAP:
2459             gtk_drag_set_icon_pixmap (context,
2460                                       site->colormap,
2461                                       site->icon_data.pixmap.pixmap,
2462                                       site->icon_mask,
2463                                       -2, -2);
2464             break;
2465           case GTK_IMAGE_PIXBUF:
2466             gtk_drag_set_icon_pixbuf (context,
2467                                       site->icon_data.pixbuf.pixbuf,
2468                                       -2, -2);
2469             break;
2470           case GTK_IMAGE_STOCK:
2471             gtk_drag_set_icon_stock (context,
2472                                      site->icon_data.stock.stock_id,
2473                                      -2, -2);
2474             break;
2475           case GTK_IMAGE_ICON_NAME:
2476             gtk_drag_set_icon_name (context,
2477                                     site->icon_data.name.icon_name,
2478                                     -2, -2);
2479             break;
2480           case GTK_IMAGE_EMPTY:
2481           default:
2482             g_assert_not_reached();
2483             break;
2484           }
2485     }
2486
2487   /* We need to composite the icon into the cursor, if we are
2488    * not using an icon window.
2489    */
2490   if (info->icon_pixbuf)
2491     {
2492       cursor = gtk_drag_get_cursor (gtk_widget_get_display (widget),
2493                                     suggested_action,
2494                                     info);
2495
2496       if (cursor != info->cursor)
2497         {
2498           gdk_pointer_grab (widget->window, FALSE,
2499                             GDK_POINTER_MOTION_MASK |
2500                             GDK_BUTTON_RELEASE_MASK,
2501                             NULL,
2502                             cursor, time);
2503           info->cursor = cursor;
2504         }
2505     }
2506
2507   if (event && event->type == GDK_MOTION_NOTIFY)
2508     gtk_drag_motion_cb (info->ipc_widget, (GdkEventMotion *)event, info);
2509   else
2510     gtk_drag_update (info, info->cur_screen, info->cur_x, info->cur_y, event);
2511
2512   info->start_x = info->cur_x;
2513   info->start_y = info->cur_y;
2514
2515   g_signal_connect (info->ipc_widget, "grab-broken-event",
2516                     G_CALLBACK (gtk_drag_grab_broken_event_cb), info);
2517   g_signal_connect (info->ipc_widget, "grab-notify",
2518                     G_CALLBACK (gtk_drag_grab_notify_cb), info);
2519   g_signal_connect (info->ipc_widget, "button-release-event",
2520                     G_CALLBACK (gtk_drag_button_release_cb), info);
2521   g_signal_connect (info->ipc_widget, "motion-notify-event",
2522                     G_CALLBACK (gtk_drag_motion_cb), info);
2523   g_signal_connect (info->ipc_widget, "key-press-event",
2524                     G_CALLBACK (gtk_drag_key_cb), info);
2525   g_signal_connect (info->ipc_widget, "key-release-event",
2526                     G_CALLBACK (gtk_drag_key_cb), info);
2527   g_signal_connect (info->ipc_widget, "selection-get",
2528                     G_CALLBACK (gtk_drag_selection_get), info);
2529
2530   info->have_grab = TRUE;
2531   info->grab_time = time;
2532
2533   return info->context;
2534 }
2535
2536 /**
2537  * gtk_drag_begin:
2538  * @widget: the source widget.
2539  * @targets: The targets (data formats) in which the
2540  *    source can provide the data.
2541  * @actions: A bitmask of the allowed drag actions for this drag.
2542  * @button: The button the user clicked to start the drag.
2543  * @event: The event that triggered the start of the drag.
2544  *
2545  * Initiates a drag on the source side. The function
2546  * only needs to be used when the application is
2547  * starting drags itself, and is not needed when
2548  * gtk_drag_source_set() is used.
2549  *
2550  * Return value: the context for this drag.
2551  **/
2552 GdkDragContext *
2553 gtk_drag_begin (GtkWidget         *widget,
2554                 GtkTargetList     *targets,
2555                 GdkDragAction      actions,
2556                 gint               button,
2557                 GdkEvent          *event)
2558 {
2559   g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2560   g_return_val_if_fail (GTK_WIDGET_REALIZED (widget), NULL);
2561   g_return_val_if_fail (targets != NULL, NULL);
2562
2563   return gtk_drag_begin_internal (widget, NULL, targets,
2564                                   actions, button, event);
2565 }
2566
2567 /*************************************************************
2568  * gtk_drag_source_set:
2569  *     Register a drop site, and possibly add default behaviors.
2570  *   arguments:
2571  *     widget:
2572  *     start_button_mask: Mask of allowed buttons to start drag
2573  *     targets:           Table of targets for this source
2574  *     n_targets:
2575  *     actions:           Actions allowed for this source
2576  *   results:
2577  *************************************************************/
2578
2579 void
2580 gtk_drag_source_set (GtkWidget            *widget,
2581                      GdkModifierType       start_button_mask,
2582                      const GtkTargetEntry *targets,
2583                      gint                  n_targets,
2584                      GdkDragAction         actions)
2585 {
2586   GtkDragSourceSite *site;
2587
2588   g_return_if_fail (GTK_IS_WIDGET (widget));
2589
2590   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2591
2592   gtk_widget_add_events (widget,
2593                          gtk_widget_get_events (widget) |
2594                          GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
2595                          GDK_BUTTON_MOTION_MASK);
2596
2597   if (site)
2598     {
2599       if (site->target_list)
2600         gtk_target_list_unref (site->target_list);
2601     }
2602   else
2603     {
2604       site = g_new0 (GtkDragSourceSite, 1);
2605
2606       site->icon_type = GTK_IMAGE_EMPTY;
2607
2608       g_signal_connect (widget, "button-press-event",
2609                         G_CALLBACK (gtk_drag_source_event_cb),
2610                         site);
2611       g_signal_connect (widget, "button-release-event",
2612                         G_CALLBACK (gtk_drag_source_event_cb),
2613                         site);
2614       g_signal_connect (widget, "motion-notify-event",
2615                         G_CALLBACK (gtk_drag_source_event_cb),
2616                         site);
2617
2618       g_object_set_data_full (G_OBJECT (widget),
2619                               I_("gtk-site-data"),
2620                               site, gtk_drag_source_site_destroy);
2621     }
2622
2623   site->start_button_mask = start_button_mask;
2624
2625   site->target_list = gtk_target_list_new (targets, n_targets);
2626
2627   site->actions = actions;
2628 }
2629
2630 /*************************************************************
2631  * gtk_drag_source_unset
2632  *     Unregister this widget as a drag source.
2633  *   arguments:
2634  *     widget:
2635  *   results:
2636  *************************************************************/
2637
2638 void
2639 gtk_drag_source_unset (GtkWidget        *widget)
2640 {
2641   GtkDragSourceSite *site;
2642
2643   g_return_if_fail (GTK_IS_WIDGET (widget));
2644
2645   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2646
2647   if (site)
2648     {
2649       g_signal_handlers_disconnect_by_func (widget,
2650                                             gtk_drag_source_event_cb,
2651                                             site);
2652       g_object_set_data (G_OBJECT (widget), I_("gtk-site-data"), NULL);
2653     }
2654 }
2655
2656 /**
2657  * gtk_drag_source_get_target_list:
2658  * @widget: a #GtkWidget
2659  *
2660  * Gets the list of targets this widget can provide for
2661  * drag-and-drop.
2662  *
2663  * Return value: the #GtkTargetList, or %NULL if none
2664  *
2665  * Since: 2.4
2666  **/
2667 GtkTargetList *
2668 gtk_drag_source_get_target_list (GtkWidget *widget)
2669 {
2670   GtkDragSourceSite *site;
2671
2672   g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2673
2674   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2675
2676   return site ? site->target_list : NULL;
2677 }
2678
2679 /**
2680  * gtk_drag_source_set_target_list:
2681  * @widget: a #GtkWidget that's a drag source
2682  * @target_list: list of draggable targets, or %NULL for none
2683  *
2684  * Changes the target types that this widget offers for drag-and-drop.
2685  * The widget must first be made into a drag source with
2686  * gtk_drag_source_set().
2687  *
2688  * Since: 2.4
2689  **/
2690 void
2691 gtk_drag_source_set_target_list (GtkWidget     *widget,
2692                                  GtkTargetList *target_list)
2693 {
2694   GtkDragSourceSite *site;
2695
2696   g_return_if_fail (GTK_IS_WIDGET (widget));
2697
2698   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2699   if (site == NULL)
2700     {
2701       g_warning ("gtk_drag_source_set_target_list() requires the widget "
2702                  "to already be a drag source.");
2703       return;
2704     }
2705
2706   if (target_list)
2707     gtk_target_list_ref (target_list);
2708
2709   if (site->target_list)
2710     gtk_target_list_unref (site->target_list);
2711
2712   site->target_list = target_list;
2713 }
2714
2715 /**
2716  * gtk_drag_source_add_text_targets:
2717  * @widget: a #GtkWidget that's is a drag source
2718  *
2719  * Add the text targets supported by #GtkSelection to
2720  * the target list of the drag source.  The targets
2721  * are added with @info = 0. If you need another value,
2722  * use gtk_target_list_add_text_targets() and
2723  * gtk_drag_source_set_target_list().
2724  *
2725  * Since: 2.6
2726  **/
2727 void
2728 gtk_drag_source_add_text_targets (GtkWidget *widget)
2729 {
2730   GtkTargetList *target_list;
2731
2732   target_list = gtk_drag_source_get_target_list (widget);
2733   if (target_list)
2734     gtk_target_list_ref (target_list);
2735   else
2736     target_list = gtk_target_list_new (NULL, 0);
2737   gtk_target_list_add_text_targets (target_list, 0);
2738   gtk_drag_source_set_target_list (widget, target_list);
2739   gtk_target_list_unref (target_list);
2740 }
2741
2742 /**
2743  * gtk_drag_source_add_image_targets:
2744  * @widget: a #GtkWidget that's is a drag source
2745  *
2746  * Add the writable image targets supported by #GtkSelection to
2747  * the target list of the drag source. The targets
2748  * are added with @info = 0. If you need another value,
2749  * use gtk_target_list_add_image_targets() and
2750  * gtk_drag_source_set_target_list().
2751  *
2752  * Since: 2.6
2753  **/
2754 void
2755 gtk_drag_source_add_image_targets (GtkWidget *widget)
2756 {
2757   GtkTargetList *target_list;
2758
2759   target_list = gtk_drag_source_get_target_list (widget);
2760   if (target_list)
2761     gtk_target_list_ref (target_list);
2762   else
2763     target_list = gtk_target_list_new (NULL, 0);
2764   gtk_target_list_add_image_targets (target_list, 0, TRUE);
2765   gtk_drag_source_set_target_list (widget, target_list);
2766   gtk_target_list_unref (target_list);
2767 }
2768
2769 /**
2770  * gtk_drag_source_add_uri_targets:
2771  * @widget: a #GtkWidget that's is a drag source
2772  *
2773  * Add the URI targets supported by #GtkSelection to
2774  * the target list of the drag source.  The targets
2775  * are added with @info = 0. If you need another value,
2776  * use gtk_target_list_add_uri_targets() and
2777  * gtk_drag_source_set_target_list().
2778  *
2779  * Since: 2.6
2780  **/
2781 void
2782 gtk_drag_source_add_uri_targets (GtkWidget *widget)
2783 {
2784   GtkTargetList *target_list;
2785
2786   target_list = gtk_drag_source_get_target_list (widget);
2787   if (target_list)
2788     gtk_target_list_ref (target_list);
2789   else
2790     target_list = gtk_target_list_new (NULL, 0);
2791   gtk_target_list_add_uri_targets (target_list, 0);
2792   gtk_drag_source_set_target_list (widget, target_list);
2793   gtk_target_list_unref (target_list);
2794 }
2795
2796 static void
2797 gtk_drag_source_unset_icon (GtkDragSourceSite *site)
2798 {
2799   switch (site->icon_type)
2800     {
2801     case GTK_IMAGE_EMPTY:
2802       break;
2803     case GTK_IMAGE_PIXMAP:
2804       if (site->icon_data.pixmap.pixmap)
2805         g_object_unref (site->icon_data.pixmap.pixmap);
2806       if (site->icon_mask)
2807         g_object_unref (site->icon_mask);
2808       break;
2809     case GTK_IMAGE_PIXBUF:
2810       g_object_unref (site->icon_data.pixbuf.pixbuf);
2811       break;
2812     case GTK_IMAGE_STOCK:
2813       g_free (site->icon_data.stock.stock_id);
2814       break;
2815     case GTK_IMAGE_ICON_NAME:
2816       g_free (site->icon_data.name.icon_name);
2817       break;
2818     default:
2819       g_assert_not_reached();
2820       break;
2821     }
2822   site->icon_type = GTK_IMAGE_EMPTY;
2823
2824   if (site->colormap)
2825     g_object_unref (site->colormap);
2826   site->colormap = NULL;
2827 }
2828
2829 /**
2830  * gtk_drag_source_set_icon:
2831  * @widget: a #GtkWidget
2832  * @colormap: the colormap of the icon
2833  * @pixmap: the image data for the icon
2834  * @mask: (allow-none): the transparency mask for an image.
2835  *
2836  * Sets the icon that will be used for drags from a particular widget
2837  * from a pixmap/mask. GTK+ retains references for the arguments, and
2838  * will release them when they are no longer needed.
2839  * Use gtk_drag_source_set_icon_pixbuf() instead.
2840  **/
2841 void
2842 gtk_drag_source_set_icon (GtkWidget     *widget,
2843                           GdkColormap   *colormap,
2844                           GdkPixmap     *pixmap,
2845                           GdkBitmap     *mask)
2846 {
2847   GtkDragSourceSite *site;
2848
2849   g_return_if_fail (GTK_IS_WIDGET (widget));
2850   g_return_if_fail (GDK_IS_COLORMAP (colormap));
2851   g_return_if_fail (GDK_IS_PIXMAP (pixmap));
2852   g_return_if_fail (!mask || GDK_IS_PIXMAP (mask));
2853
2854   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2855   g_return_if_fail (site != NULL);
2856
2857   g_object_ref (colormap);
2858   g_object_ref (pixmap);
2859   if (mask)
2860     g_object_ref (mask);
2861
2862   gtk_drag_source_unset_icon (site);
2863
2864   site->icon_type = GTK_IMAGE_PIXMAP;
2865
2866   site->icon_data.pixmap.pixmap = pixmap;
2867   site->icon_mask = mask;
2868   site->colormap = colormap;
2869 }
2870
2871 /**
2872  * gtk_drag_source_set_icon_pixbuf:
2873  * @widget: a #GtkWidget
2874  * @pixbuf: the #GdkPixbuf for the drag icon
2875  *
2876  * Sets the icon that will be used for drags from a particular widget
2877  * from a #GdkPixbuf. GTK+ retains a reference for @pixbuf and will
2878  * release it when it is no longer needed.
2879  **/
2880 void
2881 gtk_drag_source_set_icon_pixbuf (GtkWidget   *widget,
2882                                  GdkPixbuf   *pixbuf)
2883 {
2884   GtkDragSourceSite *site;
2885
2886   g_return_if_fail (GTK_IS_WIDGET (widget));
2887   g_return_if_fail (GDK_IS_PIXBUF (pixbuf));
2888
2889   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2890   g_return_if_fail (site != NULL);
2891   g_object_ref (pixbuf);
2892
2893   gtk_drag_source_unset_icon (site);
2894
2895   site->icon_type = GTK_IMAGE_PIXBUF;
2896   site->icon_data.pixbuf.pixbuf = pixbuf;
2897 }
2898
2899 /**
2900  * gtk_drag_source_set_icon_stock:
2901  * @widget: a #GtkWidget
2902  * @stock_id: the ID of the stock icon to use
2903  *
2904  * Sets the icon that will be used for drags from a particular source
2905  * to a stock icon.
2906  **/
2907 void
2908 gtk_drag_source_set_icon_stock (GtkWidget   *widget,
2909                                 const gchar *stock_id)
2910 {
2911   GtkDragSourceSite *site;
2912
2913   g_return_if_fail (GTK_IS_WIDGET (widget));
2914   g_return_if_fail (stock_id != NULL);
2915
2916   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2917   g_return_if_fail (site != NULL);
2918
2919   gtk_drag_source_unset_icon (site);
2920
2921   site->icon_type = GTK_IMAGE_STOCK;
2922   site->icon_data.stock.stock_id = g_strdup (stock_id);
2923 }
2924
2925 /**
2926  * gtk_drag_source_set_icon_name:
2927  * @widget: a #GtkWidget
2928  * @icon_name: name of icon to use
2929  *
2930  * Sets the icon that will be used for drags from a particular source
2931  * to a themed icon. See the docs for #GtkIconTheme for more details.
2932  *
2933  * Since: 2.8
2934  **/
2935 void
2936 gtk_drag_source_set_icon_name (GtkWidget   *widget,
2937                                const gchar *icon_name)
2938 {
2939   GtkDragSourceSite *site;
2940
2941   g_return_if_fail (GTK_IS_WIDGET (widget));
2942   g_return_if_fail (icon_name != NULL);
2943
2944   site = g_object_get_data (G_OBJECT (widget), "gtk-site-data");
2945   g_return_if_fail (site != NULL);
2946
2947   gtk_drag_source_unset_icon (site);
2948
2949   site->icon_type = GTK_IMAGE_ICON_NAME;
2950   site->icon_data.name.icon_name = g_strdup (icon_name);
2951 }
2952
2953 static void
2954 gtk_drag_get_icon (GtkDragSourceInfo *info,
2955                    GtkWidget        **icon_window,
2956                    gint              *hot_x,
2957                    gint              *hot_y)
2958 {
2959   if (get_can_change_screen (info->icon_window))
2960     gtk_window_set_screen (GTK_WINDOW (info->icon_window),
2961                            info->cur_screen);
2962
2963   if (gtk_widget_get_screen (info->icon_window) != info->cur_screen)
2964     {
2965       if (!info->fallback_icon)
2966         {
2967           gint save_hot_x, save_hot_y;
2968           gboolean save_destroy_icon;
2969           GtkWidget *save_icon_window;
2970
2971           /* HACK to get the appropriate icon
2972            */
2973           save_icon_window = info->icon_window;
2974           save_hot_x = info->hot_x;
2975           save_hot_y = info->hot_x;
2976           save_destroy_icon = info->destroy_icon;
2977
2978           info->icon_window = NULL;
2979           if (!default_icon_pixmap)
2980             set_icon_stock_pixbuf (info->context,
2981                                    GTK_STOCK_DND, NULL, -2, -2, TRUE);
2982           else
2983             gtk_drag_set_icon_pixmap (info->context,
2984                                       default_icon_colormap,
2985                                       default_icon_pixmap,
2986                                       default_icon_mask,
2987                                       default_icon_hot_x,
2988                                       default_icon_hot_y);
2989           info->fallback_icon = info->icon_window;
2990
2991           info->icon_window = save_icon_window;
2992           info->hot_x = save_hot_x;
2993           info->hot_y = save_hot_y;
2994           info->destroy_icon = save_destroy_icon;
2995         }
2996
2997       gtk_widget_hide (info->icon_window);
2998
2999       *icon_window = info->fallback_icon;
3000       gtk_window_set_screen (GTK_WINDOW (*icon_window), info->cur_screen);
3001
3002       if (!default_icon_pixmap)
3003         {
3004           *hot_x = -2;
3005           *hot_y = -2;
3006         }
3007       else
3008         {
3009           *hot_x = default_icon_hot_x;
3010           *hot_y = default_icon_hot_y;
3011         }
3012     }
3013   else
3014     {
3015       if (info->fallback_icon)
3016         gtk_widget_hide (info->fallback_icon);
3017
3018       *icon_window = info->icon_window;
3019       *hot_x = info->hot_x;
3020       *hot_y = info->hot_y;
3021     }
3022 }
3023
3024 static void
3025 gtk_drag_update_icon (GtkDragSourceInfo *info)
3026 {
3027   if (info->icon_window)
3028     {
3029       GtkWidget *icon_window;
3030       gint hot_x, hot_y;
3031
3032       gtk_drag_get_icon (info, &icon_window, &hot_x, &hot_y);
3033
3034       gtk_window_move (GTK_WINDOW (icon_window),
3035                        info->cur_x - hot_x,
3036                        info->cur_y - hot_y);
3037
3038       if (GTK_WIDGET_VISIBLE (icon_window))
3039         gdk_window_raise (icon_window->window);
3040       else
3041         gtk_widget_show (icon_window);
3042     }
3043 }
3044
3045 static void
3046 gtk_drag_set_icon_window (GdkDragContext *context,
3047                           GtkWidget      *widget,
3048                           gint            hot_x,
3049                           gint            hot_y,
3050                           gboolean        destroy_on_release)
3051 {
3052   GtkDragSourceInfo *info;
3053
3054   info = gtk_drag_get_source_info (context, FALSE);
3055   if (info == NULL)
3056     {
3057       if (destroy_on_release)
3058         gtk_widget_destroy (widget);
3059       return;
3060     }
3061
3062   gtk_drag_remove_icon (info);
3063
3064   if (widget)
3065     g_object_ref (widget);
3066
3067   info->icon_window = widget;
3068   info->hot_x = hot_x;
3069   info->hot_y = hot_y;
3070   info->destroy_icon = destroy_on_release;
3071
3072   if (widget && info->icon_pixbuf)
3073     {
3074       g_object_unref (info->icon_pixbuf);
3075       info->icon_pixbuf = NULL;
3076     }
3077
3078   gtk_drag_update_cursor (info);
3079   gtk_drag_update_icon (info);
3080 }
3081
3082 /**
3083  * gtk_drag_set_icon_widget:
3084  * @context: the context for a drag. (This must be called
3085           with a  context for the source side of a drag)
3086  * @widget: a toplevel window to use as an icon.
3087  * @hot_x: the X offset within @widget of the hotspot.
3088  * @hot_y: the Y offset within @widget of the hotspot.
3089  *
3090  * Changes the icon for a widget to a given widget. GTK+
3091  * will not destroy the icon, so if you don't want
3092  * it to persist, you should connect to the "drag-end"
3093  * signal and destroy it yourself.
3094  **/
3095 void
3096 gtk_drag_set_icon_widget (GdkDragContext    *context,
3097                           GtkWidget         *widget,
3098                           gint               hot_x,
3099                           gint               hot_y)
3100 {
3101   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3102   g_return_if_fail (context->is_source);
3103   g_return_if_fail (GTK_IS_WIDGET (widget));
3104
3105   gtk_drag_set_icon_window (context, widget, hot_x, hot_y, FALSE);
3106 }
3107
3108 static void
3109 icon_window_realize (GtkWidget *window,
3110                      GdkPixbuf *pixbuf)
3111 {
3112   GdkPixmap *pixmap;
3113   GdkPixmap *mask;
3114
3115   gdk_pixbuf_render_pixmap_and_mask_for_colormap (pixbuf,
3116                                                   gtk_widget_get_colormap (window),
3117                                                   &pixmap, &mask, 128);
3118
3119   gdk_window_set_back_pixmap (window->window, pixmap, FALSE);
3120   g_object_unref (pixmap);
3121
3122   if (mask)
3123     {
3124       gtk_widget_shape_combine_mask (window, mask, 0, 0);
3125       g_object_unref (mask);
3126     }
3127 }
3128
3129 static void
3130 set_icon_stock_pixbuf (GdkDragContext    *context,
3131                        const gchar       *stock_id,
3132                        GdkPixbuf         *pixbuf,
3133                        gint               hot_x,
3134                        gint               hot_y,
3135                        gboolean           force_window)
3136 {
3137   GtkWidget *window;
3138   gint width, height;
3139   GdkScreen *screen;
3140   GdkDisplay *display;
3141
3142   g_return_if_fail (context != NULL);
3143   g_return_if_fail (pixbuf != NULL || stock_id != NULL);
3144   g_return_if_fail (pixbuf == NULL || stock_id == NULL);
3145
3146   screen = gdk_drawable_get_screen (context->source_window);
3147
3148   /* Push a NULL colormap to guard against gtk_widget_push_colormap() */
3149   gtk_widget_push_colormap (NULL);
3150   window = gtk_window_new (GTK_WINDOW_POPUP);
3151   gtk_window_set_type_hint (GTK_WINDOW (window), GDK_WINDOW_TYPE_HINT_DND);
3152   gtk_window_set_screen (GTK_WINDOW (window), screen);
3153   set_can_change_screen (window, TRUE);
3154   gtk_widget_pop_colormap ();
3155
3156   gtk_widget_set_events (window, GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK);
3157   gtk_widget_set_app_paintable (window, TRUE);
3158
3159   if (stock_id)
3160     {
3161       pixbuf = gtk_widget_render_icon (window, stock_id,
3162                                        GTK_ICON_SIZE_DND, NULL);
3163
3164       if (!pixbuf)
3165         {
3166           g_warning ("Cannot load drag icon from stock_id %s", stock_id);
3167           gtk_widget_destroy (window);
3168           return;
3169         }
3170
3171     }
3172   else
3173     g_object_ref (pixbuf);
3174
3175   display = gdk_drawable_get_display (context->source_window);
3176   width = gdk_pixbuf_get_width (pixbuf);
3177   height = gdk_pixbuf_get_height (pixbuf);
3178
3179   if (!force_window &&
3180       gtk_drag_can_use_rgba_cursor (display, width + 2, height + 2))
3181     {
3182       GtkDragSourceInfo *info;
3183
3184       gtk_widget_destroy (window);
3185
3186       info = gtk_drag_get_source_info (context, FALSE);
3187
3188       if (info->icon_pixbuf)
3189         g_object_unref (info->icon_pixbuf);
3190       info->icon_pixbuf = pixbuf;
3191
3192       gtk_drag_set_icon_window (context, NULL, hot_x, hot_y, TRUE);
3193     }
3194   else
3195     {
3196       gtk_widget_set_size_request (window, width, height);
3197
3198       g_signal_connect_closure (window, "realize",
3199                                 g_cclosure_new (G_CALLBACK (icon_window_realize),
3200                                                 pixbuf,
3201                                                 (GClosureNotify)g_object_unref),
3202                                 FALSE);
3203
3204       gtk_drag_set_icon_window (context, window, hot_x, hot_y, TRUE);
3205    }
3206 }
3207
3208 /**
3209  * gtk_drag_set_icon_pixbuf:
3210  * @context: the context for a drag. (This must be called
3211  *            with a  context for the source side of a drag)
3212  * @pixbuf: the #GdkPixbuf to use as the drag icon.
3213  * @hot_x: the X offset within @widget of the hotspot.
3214  * @hot_y: the Y offset within @widget of the hotspot.
3215  *
3216  * Sets @pixbuf as the icon for a given drag.
3217  **/
3218 void
3219 gtk_drag_set_icon_pixbuf  (GdkDragContext *context,
3220                            GdkPixbuf      *pixbuf,
3221                            gint            hot_x,
3222                            gint            hot_y)
3223 {
3224   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3225   g_return_if_fail (context->is_source);
3226   g_return_if_fail (GDK_IS_PIXBUF (pixbuf));
3227
3228   set_icon_stock_pixbuf (context, NULL, pixbuf, hot_x, hot_y, FALSE);
3229 }
3230
3231 /**
3232  * gtk_drag_set_icon_stock:
3233  * @context: the context for a drag. (This must be called
3234  *            with a  context for the source side of a drag)
3235  * @stock_id: the ID of the stock icon to use for the drag.
3236  * @hot_x: the X offset within the icon of the hotspot.
3237  * @hot_y: the Y offset within the icon of the hotspot.
3238  *
3239  * Sets the icon for a given drag from a stock ID.
3240  **/
3241 void
3242 gtk_drag_set_icon_stock  (GdkDragContext *context,
3243                           const gchar    *stock_id,
3244                           gint            hot_x,
3245                           gint            hot_y)
3246 {
3247   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3248   g_return_if_fail (context->is_source);
3249   g_return_if_fail (stock_id != NULL);
3250
3251   set_icon_stock_pixbuf (context, stock_id, NULL, hot_x, hot_y, FALSE);
3252 }
3253
3254 /**
3255  * gtk_drag_set_icon_pixmap:
3256  * @context: the context for a drag. (This must be called
3257  *            with a  context for the source side of a drag)
3258  * @colormap: the colormap of the icon
3259  * @pixmap: the image data for the icon
3260  * @mask: the transparency mask for the icon or %NULL for none.
3261  * @hot_x: the X offset within @pixmap of the hotspot.
3262  * @hot_y: the Y offset within @pixmap of the hotspot.
3263  *
3264  * Sets @pixmap as the icon for a given drag. GTK+ retains
3265  * references for the arguments, and will release them when
3266  * they are no longer needed. In general, gtk_drag_set_icon_pixbuf()
3267  * will be more convenient to use.
3268  **/
3269 void
3270 gtk_drag_set_icon_pixmap (GdkDragContext    *context,
3271                           GdkColormap       *colormap,
3272                           GdkPixmap         *pixmap,
3273                           GdkBitmap         *mask,
3274                           gint               hot_x,
3275                           gint               hot_y)
3276 {
3277   GtkWidget *window;
3278   GdkScreen *screen;
3279   gint width, height;
3280
3281   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3282   g_return_if_fail (context->is_source);
3283   g_return_if_fail (GDK_IS_COLORMAP (colormap));
3284   g_return_if_fail (GDK_IS_PIXMAP (pixmap));
3285   g_return_if_fail (!mask || GDK_IS_PIXMAP (mask));
3286
3287   screen = gdk_colormap_get_screen (colormap);
3288
3289   g_return_if_fail (gdk_drawable_get_screen (pixmap) == screen);
3290   g_return_if_fail (!mask || gdk_drawable_get_screen (mask) == screen);
3291
3292   gdk_drawable_get_size (pixmap, &width, &height);
3293
3294   gtk_widget_push_colormap (colormap);
3295
3296   window = gtk_window_new (GTK_WINDOW_POPUP);
3297   gtk_window_set_type_hint (GTK_WINDOW (window), GDK_WINDOW_TYPE_HINT_DND);
3298   gtk_window_set_screen (GTK_WINDOW (window), screen);
3299   set_can_change_screen (window, FALSE);
3300   gtk_widget_set_events (window, GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK);
3301   gtk_widget_set_app_paintable (GTK_WIDGET (window), TRUE);
3302
3303   gtk_widget_pop_colormap ();
3304
3305   gtk_widget_set_size_request (window, width, height);
3306   gtk_widget_realize (window);
3307
3308   gdk_window_set_back_pixmap (window->window, pixmap, FALSE);
3309
3310   if (mask)
3311     gtk_widget_shape_combine_mask (window, mask, 0, 0);
3312
3313   gtk_drag_set_icon_window (context, window, hot_x, hot_y, TRUE);
3314 }
3315
3316 /**
3317  * gtk_drag_set_icon_name:
3318  * @context: the context for a drag. (This must be called
3319  *            with a context for the source side of a drag)
3320  * @icon_name: name of icon to use
3321  * @hot_x: the X offset of the hotspot within the icon
3322  * @hot_y: the Y offset of the hotspot within the icon
3323  *
3324  * Sets the icon for a given drag from a named themed icon. See
3325  * the docs for #GtkIconTheme for more details. Note that the
3326  * size of the icon depends on the icon theme (the icon is
3327  * loaded at the symbolic size #GTK_ICON_SIZE_DND), thus
3328  * @hot_x and @hot_y have to be used with care.
3329  *
3330  * Since: 2.8
3331  **/
3332 void
3333 gtk_drag_set_icon_name (GdkDragContext *context,
3334                         const gchar    *icon_name,
3335                         gint            hot_x,
3336                         gint            hot_y)
3337 {
3338   GdkScreen *screen;
3339   GtkSettings *settings;
3340   GtkIconTheme *icon_theme;
3341   GdkPixbuf *pixbuf;
3342   gint width, height, icon_size;
3343
3344   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3345   g_return_if_fail (context->is_source);
3346   g_return_if_fail (icon_name != NULL);
3347
3348   screen = gdk_drawable_get_screen (context->source_window);
3349   g_return_if_fail (screen != NULL);
3350
3351   settings = gtk_settings_get_for_screen (screen);
3352   if (gtk_icon_size_lookup_for_settings (settings,
3353                                          GTK_ICON_SIZE_DND,
3354                                          &width, &height))
3355     icon_size = MAX (width, height);
3356   else
3357     icon_size = 32; /* default value for GTK_ICON_SIZE_DND */
3358
3359   icon_theme = gtk_icon_theme_get_for_screen (screen);
3360
3361   pixbuf = gtk_icon_theme_load_icon (icon_theme, icon_name,
3362                                      icon_size, 0, NULL);
3363   if (pixbuf)
3364     set_icon_stock_pixbuf (context, NULL, pixbuf, hot_x, hot_y, FALSE);
3365   else
3366     g_warning ("Cannot load drag icon from icon name %s", icon_name);
3367 }
3368
3369 /**
3370  * gtk_drag_set_icon_default:
3371  * @context: the context for a drag. (This must be called
3372              with a  context for the source side of a drag)
3373  *
3374  * Sets the icon for a particular drag to the default
3375  * icon.
3376  **/
3377 void
3378 gtk_drag_set_icon_default (GdkDragContext *context)
3379 {
3380   g_return_if_fail (GDK_IS_DRAG_CONTEXT (context));
3381   g_return_if_fail (context->is_source);
3382
3383   if (!default_icon_pixmap)
3384     gtk_drag_set_icon_stock (context, GTK_STOCK_DND, -2, -2);
3385   else
3386     gtk_drag_set_icon_pixmap (context,
3387                               default_icon_colormap,
3388                               default_icon_pixmap,
3389                               default_icon_mask,
3390                               default_icon_hot_x,
3391                               default_icon_hot_y);
3392 }
3393
3394 /**
3395  * gtk_drag_set_default_icon:
3396  * @colormap: the colormap of the icon
3397  * @pixmap: the image data for the icon
3398  * @mask: the transparency mask for an image.
3399  * @hot_x: The X offset within @widget of the hotspot.
3400  * @hot_y: The Y offset within @widget of the hotspot.
3401  *
3402  * Changes the default drag icon. GTK+ retains references for the
3403  * arguments, and will release them when they are no longer needed.
3404  *
3405  * Deprecated: Change the default drag icon via the stock system by
3406  *     changing the stock pixbuf for #GTK_STOCK_DND instead.
3407  **/
3408 void
3409 gtk_drag_set_default_icon (GdkColormap   *colormap,
3410                            GdkPixmap     *pixmap,
3411                            GdkBitmap     *mask,
3412                            gint           hot_x,
3413                            gint           hot_y)
3414 {
3415   g_return_if_fail (GDK_IS_COLORMAP (colormap));
3416   g_return_if_fail (GDK_IS_PIXMAP (pixmap));
3417   g_return_if_fail (!mask || GDK_IS_PIXMAP (mask));
3418
3419   if (default_icon_colormap)
3420     g_object_unref (default_icon_colormap);
3421   if (default_icon_pixmap)
3422     g_object_unref (default_icon_pixmap);
3423   if (default_icon_mask)
3424     g_object_unref (default_icon_mask);
3425
3426   default_icon_colormap = colormap;
3427   g_object_ref (colormap);
3428
3429   default_icon_pixmap = pixmap;
3430   g_object_ref (pixmap);
3431
3432   default_icon_mask = mask;
3433   if (mask)
3434     g_object_ref (mask);
3435
3436   default_icon_hot_x = hot_x;
3437   default_icon_hot_y = hot_y;
3438 }
3439
3440
3441 /*************************************************************
3442  * _gtk_drag_source_handle_event:
3443  *     Called from widget event handling code on Drag events
3444  *     for drag sources.
3445  *
3446  *   arguments:
3447  *     toplevel: Toplevel widget that received the event
3448  *     event:
3449  *   results:
3450  *************************************************************/
3451
3452 void
3453 _gtk_drag_source_handle_event (GtkWidget *widget,
3454                                GdkEvent  *event)
3455 {
3456   GtkDragSourceInfo *info;
3457   GdkDragContext *context;
3458
3459   g_return_if_fail (widget != NULL);
3460   g_return_if_fail (event != NULL);
3461
3462   context = event->dnd.context;
3463   info = gtk_drag_get_source_info (context, FALSE);
3464   if (!info)
3465     return;
3466
3467   switch (event->type)
3468     {
3469     case GDK_DRAG_STATUS:
3470       {
3471         GdkCursor *cursor;
3472
3473         if (info->proxy_dest)
3474           {
3475             if (!event->dnd.send_event)
3476               {
3477                 if (info->proxy_dest->proxy_drop_wait)
3478                   {
3479                     gboolean result = context->action != 0;
3480
3481                     /* Aha - we can finally pass the MOTIF DROP on... */
3482                     gdk_drop_reply (info->proxy_dest->context, result, info->proxy_dest->proxy_drop_time);
3483                     if (result)
3484                       gdk_drag_drop (info->context, info->proxy_dest->proxy_drop_time);
3485                     else
3486                       gtk_drag_finish (info->proxy_dest->context, FALSE, FALSE, info->proxy_dest->proxy_drop_time);
3487                   }
3488                 else
3489                   {
3490                     gdk_drag_status (info->proxy_dest->context,
3491                                      event->dnd.context->action,
3492                                      event->dnd.time);
3493                   }
3494               }
3495           }
3496         else if (info->have_grab)
3497           {
3498             cursor = gtk_drag_get_cursor (gtk_widget_get_display (widget),
3499                                           event->dnd.context->action,
3500                                           info);
3501             if (info->cursor != cursor)
3502               {
3503                 gdk_pointer_grab (widget->window, FALSE,
3504                                   GDK_POINTER_MOTION_MASK |
3505                                   GDK_BUTTON_RELEASE_MASK,
3506                                   NULL,
3507                                   cursor, info->grab_time);
3508                 info->cursor = cursor;
3509               }
3510
3511             gtk_drag_add_update_idle (info);
3512           }
3513       }
3514       break;
3515
3516     case GDK_DROP_FINISHED:
3517       gtk_drag_drop_finished (info, GTK_DRAG_RESULT_SUCCESS, event->dnd.time);
3518       break;
3519     default:
3520       g_assert_not_reached ();
3521     }
3522 }
3523
3524 /*************************************************************
3525  * gtk_drag_source_check_selection:
3526  *     Check if we've set up handlers/claimed the selection
3527  *     for a given drag. If not, add them.
3528  *   arguments:
3529  *
3530  *   results:
3531  *************************************************************/
3532
3533 static void
3534 gtk_drag_source_check_selection (GtkDragSourceInfo *info,
3535                                  GdkAtom            selection,
3536                                  guint32            time)
3537 {
3538   GList *tmp_list;
3539
3540   tmp_list = info->selections;
3541   while (tmp_list)
3542     {
3543       if (GDK_POINTER_TO_ATOM (tmp_list->data) == selection)
3544         return;
3545       tmp_list = tmp_list->next;
3546     }
3547
3548   gtk_selection_owner_set_for_display (gtk_widget_get_display (info->widget),
3549                                        info->ipc_widget,
3550                                        selection,
3551                                        time);
3552   info->selections = g_list_prepend (info->selections,
3553                                      GUINT_TO_POINTER (selection));
3554
3555   tmp_list = info->target_list->list;
3556   while (tmp_list)
3557     {
3558       GtkTargetPair *pair = tmp_list->data;
3559
3560       gtk_selection_add_target (info->ipc_widget,
3561                                 selection,
3562                                 pair->target,
3563                                 pair->info);
3564       tmp_list = tmp_list->next;
3565     }
3566
3567   if (info->context->protocol == GDK_DRAG_PROTO_MOTIF)
3568     {
3569       gtk_selection_add_target (info->ipc_widget,
3570                                 selection,
3571                                 gdk_atom_intern_static_string ("XmTRANSFER_SUCCESS"),
3572                                 TARGET_MOTIF_SUCCESS);
3573       gtk_selection_add_target (info->ipc_widget,
3574                                 selection,
3575                                 gdk_atom_intern_static_string ("XmTRANSFER_FAILURE"),
3576                                 TARGET_MOTIF_FAILURE);
3577     }
3578
3579   gtk_selection_add_target (info->ipc_widget,
3580                             selection,
3581                             gdk_atom_intern_static_string ("DELETE"),
3582                             TARGET_DELETE);
3583 }
3584
3585 /*************************************************************
3586  * gtk_drag_drop_finished:
3587  *     Clean up from the drag, and display snapback, if necessary.
3588  *   arguments:
3589  *     info:
3590  *     success:
3591  *     time:
3592  *   results:
3593  *************************************************************/
3594
3595 static void
3596 gtk_drag_drop_finished (GtkDragSourceInfo *info,
3597                         GtkDragResult      result,
3598                         guint              time)
3599 {
3600   gboolean success;
3601
3602   success = (result == GTK_DRAG_RESULT_SUCCESS);
3603   gtk_drag_source_release_selections (info, time);
3604
3605   if (info->proxy_dest)
3606     {
3607       /* The time from the event isn't reliable for Xdnd drags */
3608       gtk_drag_finish (info->proxy_dest->context, success, FALSE,
3609                        info->proxy_dest->proxy_drop_time);
3610       gtk_drag_source_info_destroy (info);
3611     }
3612   else
3613     {
3614       if (!success)
3615         g_signal_emit_by_name (info->widget, "drag-failed",
3616                                info->context, result, &success);
3617
3618       if (success)
3619         {
3620           gtk_drag_source_info_destroy (info);
3621         }
3622       else
3623         {
3624           GtkDragAnim *anim = g_new (GtkDragAnim, 1);
3625           anim->info = info;
3626           anim->step = 0;
3627
3628           anim->n_steps = MAX (info->cur_x - info->start_x,
3629                                info->cur_y - info->start_y) / ANIM_STEP_LENGTH;
3630           anim->n_steps = CLAMP (anim->n_steps, ANIM_MIN_STEPS, ANIM_MAX_STEPS);
3631
3632           info->cur_screen = gtk_widget_get_screen (info->widget);
3633
3634           if (!info->icon_window)
3635             set_icon_stock_pixbuf (info->context, NULL, info->icon_pixbuf,
3636                                    0, 0, TRUE);
3637
3638           gtk_drag_update_icon (info);
3639
3640           /* Mark the context as dead, so if the destination decides
3641            * to respond really late, we still are OK.
3642            */
3643           gtk_drag_clear_source_info (info->context);
3644           gdk_threads_add_timeout (ANIM_STEP_TIME, gtk_drag_anim_timeout, anim);
3645         }
3646     }
3647 }
3648
3649 static void
3650 gtk_drag_source_release_selections (GtkDragSourceInfo *info,
3651                                     guint32            time)
3652 {
3653   GdkDisplay *display = gtk_widget_get_display (info->widget);
3654   GList *tmp_list = info->selections;
3655
3656   while (tmp_list)
3657     {
3658       GdkAtom selection = GDK_POINTER_TO_ATOM (tmp_list->data);
3659       if (gdk_selection_owner_get_for_display (display, selection) == info->ipc_widget->window)
3660         gtk_selection_owner_set_for_display (display, NULL, selection, time);
3661
3662       tmp_list = tmp_list->next;
3663     }
3664
3665   g_list_free (info->selections);
3666   info->selections = NULL;
3667 }
3668
3669 /*************************************************************
3670  * gtk_drag_drop:
3671  *     Send a drop event.
3672  *   arguments:
3673  *
3674  *   results:
3675  *************************************************************/
3676
3677 static void
3678 gtk_drag_drop (GtkDragSourceInfo *info,
3679                guint32            time)
3680 {
3681   if (info->context->protocol == GDK_DRAG_PROTO_ROOTWIN)
3682     {
3683       GtkSelectionData selection_data;
3684       GList *tmp_list;
3685       /* GTK+ traditionally has used application/x-rootwin-drop, but the
3686        * XDND spec specifies x-rootwindow-drop.
3687        */
3688       GdkAtom target1 = gdk_atom_intern_static_string ("application/x-rootwindow-drop");
3689       GdkAtom target2 = gdk_atom_intern_static_string ("application/x-rootwin-drop");
3690
3691       tmp_list = info->target_list->list;
3692       while (tmp_list)
3693         {
3694           GtkTargetPair *pair = tmp_list->data;
3695
3696           if (pair->target == target1 || pair->target == target2)
3697             {
3698               selection_data.selection = GDK_NONE;
3699               selection_data.target = pair->target;
3700               selection_data.data = NULL;
3701               selection_data.length = -1;
3702
3703               g_signal_emit_by_name (info->widget, "drag-data-get",
3704                                      info->context, &selection_data,
3705                                      pair->info,
3706                                      time);
3707
3708               /* FIXME: Should we check for length >= 0 here? */
3709               gtk_drag_drop_finished (info, GTK_DRAG_RESULT_SUCCESS, time);
3710               return;
3711             }
3712           tmp_list = tmp_list->next;
3713         }
3714       gtk_drag_drop_finished (info, GTK_DRAG_RESULT_NO_TARGET, time);
3715     }
3716   else
3717     {
3718       if (info->icon_window)
3719         gtk_widget_hide (info->icon_window);
3720
3721       gdk_drag_drop (info->context, time);
3722       info->drop_timeout = gdk_threads_add_timeout (DROP_ABORT_TIME,
3723                                           gtk_drag_abort_timeout,
3724                                           info);
3725     }
3726 }
3727
3728 /*
3729  * Source side callbacks.
3730  */
3731
3732 static gboolean
3733 gtk_drag_source_event_cb (GtkWidget      *widget,
3734                           GdkEvent       *event,
3735                           gpointer        data)
3736 {
3737   GtkDragSourceSite *site;
3738   gboolean retval = FALSE;
3739   site = (GtkDragSourceSite *)data;
3740
3741   switch (event->type)
3742     {
3743     case GDK_BUTTON_PRESS:
3744       if ((GDK_BUTTON1_MASK << (event->button.button - 1)) & site->start_button_mask)
3745         {
3746           site->state |= (GDK_BUTTON1_MASK << (event->button.button - 1));
3747           site->x = event->button.x;
3748           site->y = event->button.y;
3749         }
3750       break;
3751
3752     case GDK_BUTTON_RELEASE:
3753       if ((GDK_BUTTON1_MASK << (event->button.button - 1)) & site->start_button_mask)
3754         site->state &= ~(GDK_BUTTON1_MASK << (event->button.button - 1));
3755       break;
3756
3757     case GDK_MOTION_NOTIFY:
3758       if (site->state & event->motion.state & site->start_button_mask)
3759         {
3760           /* FIXME: This is really broken and can leave us
3761            * with a stuck grab
3762            */
3763           int i;
3764           for (i=1; i<6; i++)
3765             {
3766               if (site->state & event->motion.state &
3767                   GDK_BUTTON1_MASK << (i - 1))
3768                 break;
3769             }
3770
3771           if (gtk_drag_check_threshold (widget, site->x, site->y,
3772                                         event->motion.x, event->motion.y))
3773             {
3774               site->state = 0;
3775               gtk_drag_begin_internal (widget, site, site->target_list,
3776                                        site->actions,
3777                                        i, event);
3778
3779               retval = TRUE;
3780             }
3781         }
3782       break;
3783
3784     default:                    /* hit for 2/3BUTTON_PRESS */
3785       break;
3786     }
3787
3788   return retval;
3789 }
3790
3791 static void
3792 gtk_drag_source_site_destroy (gpointer data)
3793 {
3794   GtkDragSourceSite *site = data;
3795
3796   if (site->target_list)
3797     gtk_target_list_unref (site->target_list);
3798
3799   gtk_drag_source_unset_icon (site);
3800   g_free (site);
3801 }
3802
3803 static void
3804 gtk_drag_selection_get (GtkWidget        *widget,
3805                         GtkSelectionData *selection_data,
3806                         guint             sel_info,
3807                         guint32           time,
3808                         gpointer          data)
3809 {
3810   GtkDragSourceInfo *info = data;
3811   static GdkAtom null_atom = GDK_NONE;
3812   guint target_info;
3813
3814   if (!null_atom)
3815     null_atom = gdk_atom_intern_static_string ("NULL");
3816
3817   switch (sel_info)
3818     {
3819     case TARGET_DELETE:
3820       g_signal_emit_by_name (info->widget,
3821                              "drag-data-delete",
3822                              info->context);
3823       gtk_selection_data_set (selection_data, null_atom, 8, NULL, 0);
3824       break;
3825     case TARGET_MOTIF_SUCCESS:
3826       gtk_drag_drop_finished (info, GTK_DRAG_RESULT_SUCCESS, time);
3827       gtk_selection_data_set (selection_data, null_atom, 8, NULL, 0);
3828       break;
3829     case TARGET_MOTIF_FAILURE:
3830       gtk_drag_drop_finished (info, GTK_DRAG_RESULT_NO_TARGET, time);
3831       gtk_selection_data_set (selection_data, null_atom, 8, NULL, 0);
3832       break;
3833     default:
3834       if (info->proxy_dest)
3835         {
3836           /* This is sort of dangerous and needs to be thought
3837            * through better
3838            */
3839           info->proxy_dest->proxy_data = selection_data;
3840           gtk_drag_get_data (info->widget,
3841                              info->proxy_dest->context,
3842                              selection_data->target,
3843                              time);
3844           gtk_main ();
3845           info->proxy_dest->proxy_data = NULL;
3846         }
3847       else
3848         {
3849           if (gtk_target_list_find (info->target_list,
3850                                     selection_data->target,
3851                                     &target_info))
3852             {
3853               g_signal_emit_by_name (info->widget, "drag-data-get",
3854                                      info->context,
3855                                      selection_data,
3856                                      target_info,
3857                                      time);
3858             }
3859         }
3860       break;
3861     }
3862 }
3863
3864 static gboolean
3865 gtk_drag_anim_timeout (gpointer data)
3866 {
3867   GtkDragAnim *anim = data;
3868   gint x, y;
3869   gboolean retval;
3870
3871   if (anim->step == anim->n_steps)
3872     {
3873       gtk_drag_source_info_destroy (anim->info);
3874       g_free (anim);
3875
3876       retval = FALSE;
3877     }
3878   else
3879     {
3880       x = (anim->info->start_x * (anim->step + 1) +
3881            anim->info->cur_x * (anim->n_steps - anim->step - 1)) / anim->n_steps;
3882       y = (anim->info->start_y * (anim->step + 1) +
3883            anim->info->cur_y * (anim->n_steps - anim->step - 1)) / anim->n_steps;
3884       if (anim->info->icon_window)
3885         {
3886           GtkWidget *icon_window;
3887           gint hot_x, hot_y;
3888
3889           gtk_drag_get_icon (anim->info, &icon_window, &hot_x, &hot_y);
3890           gtk_window_move (GTK_WINDOW (icon_window),
3891                            x - hot_x,
3892                            y - hot_y);
3893         }
3894
3895       anim->step++;
3896
3897       retval = TRUE;
3898     }
3899
3900   return retval;
3901 }
3902
3903 static void
3904 gtk_drag_remove_icon (GtkDragSourceInfo *info)
3905 {
3906   if (info->icon_window)
3907     {
3908       gtk_widget_hide (info->icon_window);
3909       if (info->destroy_icon)
3910         gtk_widget_destroy (info->icon_window);
3911
3912       if (info->fallback_icon)
3913         {
3914           gtk_widget_destroy (info->fallback_icon);
3915           info->fallback_icon = NULL;
3916         }
3917
3918       g_object_unref (info->icon_window);
3919       info->icon_window = NULL;
3920     }
3921 }
3922
3923 static void
3924 gtk_drag_source_info_destroy (GtkDragSourceInfo *info)
3925 {
3926   gint i;
3927
3928   for (i = 0; i < n_drag_cursors; i++)
3929     {
3930       if (info->drag_cursors[i] != NULL)
3931         {
3932           gdk_cursor_unref (info->drag_cursors[i]);
3933           info->drag_cursors[i] = NULL;
3934         }
3935     }
3936
3937   gtk_drag_remove_icon (info);
3938
3939   if (info->icon_pixbuf)
3940     {
3941       g_object_unref (info->icon_pixbuf);
3942       info->icon_pixbuf = NULL;
3943     }
3944
3945   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3946                                         gtk_drag_grab_broken_event_cb,
3947                                         info);
3948   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3949                                         gtk_drag_grab_notify_cb,
3950                                         info);
3951   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3952                                         gtk_drag_button_release_cb,
3953                                         info);
3954   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3955                                         gtk_drag_motion_cb,
3956                                         info);
3957   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3958                                         gtk_drag_key_cb,
3959                                         info);
3960   g_signal_handlers_disconnect_by_func (info->ipc_widget,
3961                                         gtk_drag_selection_get,
3962                                         info);
3963
3964   if (!info->proxy_dest)
3965     g_signal_emit_by_name (info->widget, "drag-end", info->context);
3966
3967   if (info->widget)
3968     g_object_unref (info->widget);
3969
3970   gtk_selection_remove_all (info->ipc_widget);
3971   g_object_set_data (G_OBJECT (info->ipc_widget), I_("gtk-info"), NULL);
3972   source_widgets = g_slist_remove (source_widgets, info->ipc_widget);
3973   gtk_drag_release_ipc_widget (info->ipc_widget);
3974
3975   gtk_target_list_unref (info->target_list);
3976
3977   gtk_drag_clear_source_info (info->context);
3978   g_object_unref (info->context);
3979
3980   if (info->drop_timeout)
3981     g_source_remove (info->drop_timeout);
3982
3983   if (info->update_idle)
3984     g_source_remove (info->update_idle);
3985
3986   g_free (info);
3987 }
3988
3989 static gboolean
3990 gtk_drag_update_idle (gpointer data)
3991 {
3992   GtkDragSourceInfo *info = data;
3993   GdkWindow *dest_window;
3994   GdkDragProtocol protocol;
3995   GdkAtom selection;
3996
3997   GdkDragAction action;
3998   GdkDragAction possible_actions;
3999   guint32 time;
4000
4001   info->update_idle = 0;
4002
4003   if (info->last_event)
4004     {
4005       time = gtk_drag_get_event_time (info->last_event);
4006       gtk_drag_get_event_actions (info->last_event,
4007                                   info->button,
4008                                   info->possible_actions,
4009                                   &action, &possible_actions);
4010       gtk_drag_update_icon (info);
4011       gdk_drag_find_window_for_screen (info->context,
4012                                        info->icon_window ? info->icon_window->window : NULL,
4013                                        info->cur_screen, info->cur_x, info->cur_y,
4014                                        &dest_window, &protocol);
4015
4016       if (!gdk_drag_motion (info->context, dest_window, protocol,
4017                             info->cur_x, info->cur_y, action,
4018                             possible_actions,
4019                             time))
4020         {
4021           gdk_event_free ((GdkEvent *)info->last_event);
4022           info->last_event = NULL;
4023         }
4024
4025       if (dest_window)
4026         g_object_unref (dest_window);
4027
4028       selection = gdk_drag_get_selection (info->context);
4029       if (selection)
4030         gtk_drag_source_check_selection (info, selection, time);
4031
4032     }
4033
4034   return FALSE;
4035 }
4036
4037 static void
4038 gtk_drag_add_update_idle (GtkDragSourceInfo *info)
4039 {
4040   /* We use an idle lower than GDK_PRIORITY_REDRAW so that exposes
4041    * from the last move can catch up before we move again.
4042    */
4043   if (!info->update_idle)
4044     info->update_idle = gdk_threads_add_idle_full (GDK_PRIORITY_REDRAW + 5,
4045                                          gtk_drag_update_idle,
4046                                          info,
4047                                          NULL);
4048 }
4049
4050 /**
4051  * gtk_drag_update:
4052  * @info: DragSourceInfo for the drag
4053  * @screen: new screen
4054  * @x_root: new X position
4055  * @y_root: new y position
4056  * @event: event received requiring update
4057  *
4058  * Updates the status of the drag; called when the
4059  * cursor moves or the modifier changes
4060  **/
4061 static void
4062 gtk_drag_update (GtkDragSourceInfo *info,
4063                  GdkScreen         *screen,
4064                  gint               x_root,
4065                  gint               y_root,
4066                  GdkEvent          *event)
4067 {
4068   info->cur_screen = screen;
4069   info->cur_x = x_root;
4070   info->cur_y = y_root;
4071   if (info->last_event)
4072     {
4073       gdk_event_free ((GdkEvent *)info->last_event);
4074       info->last_event = NULL;
4075     }
4076   if (event)
4077     info->last_event = gdk_event_copy ((GdkEvent *)event);
4078
4079   gtk_drag_add_update_idle (info);
4080 }
4081
4082 /*************************************************************
4083  * gtk_drag_end:
4084  *     Called when the user finishes to drag, either by
4085  *     releasing the mouse, or by pressing Esc.
4086  *   arguments:
4087  *     info: Source info for the drag
4088  *     time: Timestamp for ending the drag
4089  *   results:
4090  *************************************************************/
4091
4092 static void
4093 gtk_drag_end (GtkDragSourceInfo *info, guint32 time)
4094 {
4095   GdkEvent *send_event;
4096   GtkWidget *source_widget = info->widget;
4097   GdkDisplay *display = gtk_widget_get_display (source_widget);
4098
4099   if (info->update_idle)
4100     {
4101       g_source_remove (info->update_idle);
4102       info->update_idle = 0;
4103     }
4104
4105   if (info->last_event)
4106     {
4107       gdk_event_free (info->last_event);
4108       info->last_event = NULL;
4109     }
4110
4111   info->have_grab = FALSE;
4112
4113   g_signal_handlers_disconnect_by_func (info->ipc_widget,
4114                                         gtk_drag_grab_broken_event_cb,
4115                                         info);
4116   g_signal_handlers_disconnect_by_func (info->ipc_widget,
4117                                         gtk_drag_grab_notify_cb,
4118                                         info);
4119   g_signal_handlers_disconnect_by_func (info->ipc_widget,
4120                                         gtk_drag_button_release_cb,
4121                                         info);
4122   g_signal_handlers_disconnect_by_func (info->ipc_widget,
4123                                         gtk_drag_motion_cb,
4124                                         info);
4125   g_signal_handlers_disconnect_by_func (info->ipc_widget,
4126                                         gtk_drag_key_cb,
4127                                         info);
4128
4129   gdk_display_pointer_ungrab (display, time);
4130   ungrab_dnd_keys (info->ipc_widget, time);
4131   gtk_grab_remove (info->ipc_widget);
4132
4133   /* Send on a release pair to the original
4134    * widget to convince it to release its grab. We need to
4135    * call gtk_propagate_event() here, instead of
4136    * gtk_widget_event() because widget like GtkList may
4137    * expect propagation.
4138    */
4139
4140   send_event = gdk_event_new (GDK_BUTTON_RELEASE);
4141   send_event->button.window = g_object_ref (gtk_widget_get_root_window (source_widget));
4142   send_event->button.send_event = TRUE;
4143   send_event->button.time = time;
4144   send_event->button.x = 0;
4145   send_event->button.y = 0;
4146   send_event->button.axes = NULL;
4147   send_event->button.state = 0;
4148   send_event->button.button = info->button;
4149   send_event->button.device = gdk_display_get_core_pointer (display);
4150   send_event->button.x_root = 0;
4151   send_event->button.y_root = 0;
4152
4153   gtk_propagate_event (source_widget, send_event);
4154   gdk_event_free (send_event);
4155 }
4156
4157 /*************************************************************
4158  * gtk_drag_cancel:
4159  *    Called on cancellation of a drag, either by the user
4160  *    or programmatically.
4161  *   arguments:
4162  *     info: Source info for the drag
4163  *     time: Timestamp for ending the drag
4164  *   results:
4165  *************************************************************/
4166
4167 static void
4168 gtk_drag_cancel (GtkDragSourceInfo *info, GtkDragResult result, guint32 time)
4169 {
4170   gtk_drag_end (info, time);
4171   gdk_drag_abort (info->context, time);
4172   gtk_drag_drop_finished (info, result, time);
4173 }
4174
4175 /*************************************************************
4176  * gtk_drag_motion_cb:
4177  *     "motion-notify-event" callback during drag.
4178  *   arguments:
4179  *
4180  *   results:
4181  *************************************************************/
4182
4183 static gboolean
4184 gtk_drag_motion_cb (GtkWidget      *widget,
4185                     GdkEventMotion *event,
4186                     gpointer        data)
4187 {
4188   GtkDragSourceInfo *info = (GtkDragSourceInfo *)data;
4189   GdkScreen *screen;
4190   gint x_root, y_root;
4191
4192   if (event->is_hint)
4193     {
4194       GdkDisplay *display = gtk_widget_get_display (widget);
4195
4196       gdk_display_get_pointer (display, &screen, &x_root, &y_root, NULL);
4197       event->x_root = x_root;
4198       event->y_root = y_root;
4199     }
4200   else
4201     screen = gdk_event_get_screen ((GdkEvent *)event);
4202
4203   gtk_drag_update (info, screen, event->x_root, event->y_root, (GdkEvent *)event);
4204
4205   return TRUE;
4206 }
4207
4208 /*************************************************************
4209  * gtk_drag_key_cb:
4210  *     "key-press/release-event" callback during drag.
4211  *   arguments:
4212  *
4213  *   results:
4214  *************************************************************/
4215
4216 #define BIG_STEP 20
4217 #define SMALL_STEP 1
4218
4219 static gboolean
4220 gtk_drag_key_cb (GtkWidget         *widget,
4221                  GdkEventKey       *event,
4222                  gpointer           data)
4223 {
4224   GtkDragSourceInfo *info = (GtkDragSourceInfo *)data;
4225   GdkModifierType state;
4226   GdkWindow *root_window;
4227   gint dx, dy;
4228
4229   dx = dy = 0;
4230   state = event->state & gtk_accelerator_get_default_mod_mask ();
4231
4232   if (event->type == GDK_KEY_PRESS)
4233     {
4234       switch (event->keyval)
4235         {
4236         case GDK_Escape:
4237           gtk_drag_cancel (info, GTK_DRAG_RESULT_USER_CANCELLED, event->time);
4238           return TRUE;
4239
4240         case GDK_space:
4241         case GDK_Return:
4242         case GDK_ISO_Enter:
4243         case GDK_KP_Enter:
4244         case GDK_KP_Space:
4245           gtk_drag_end (info, event->time);
4246           gtk_drag_drop (info, event->time);
4247           return TRUE;
4248
4249         case GDK_Up:
4250         case GDK_KP_Up:
4251           dy = (state & GDK_MOD1_MASK) ? -BIG_STEP : -SMALL_STEP;
4252           break;
4253
4254         case GDK_Down:
4255         case GDK_KP_Down:
4256           dy = (state & GDK_MOD1_MASK) ? BIG_STEP : SMALL_STEP;
4257           break;
4258
4259         case GDK_Left:
4260         case GDK_KP_Left:
4261           dx = (state & GDK_MOD1_MASK) ? -BIG_STEP : -SMALL_STEP;
4262           break;
4263
4264         case GDK_Right:
4265         case GDK_KP_Right:
4266           dx = (state & GDK_MOD1_MASK) ? BIG_STEP : SMALL_STEP;
4267           break;
4268         }
4269
4270     }
4271
4272   /* Now send a "motion" so that the modifier state is updated */
4273
4274   /* The state is not yet updated in the event, so we need
4275    * to query it here. We could use XGetModifierMapping, but
4276    * that would be overkill.
4277    */
4278   root_window = gtk_widget_get_root_window (widget);
4279   gdk_window_get_pointer (root_window, NULL, NULL, &state);
4280   event->state = state;
4281
4282   if (dx != 0 || dy != 0)
4283     {
4284       info->cur_x += dx;
4285       info->cur_y += dy;
4286       gdk_display_warp_pointer (gtk_widget_get_display (widget),
4287                                 gtk_widget_get_screen (widget),
4288                                 info->cur_x, info->cur_y);
4289     }
4290
4291   gtk_drag_update (info, info->cur_screen, info->cur_x, info->cur_y, (GdkEvent *)event);
4292
4293   return TRUE;
4294 }
4295
4296 static gboolean
4297 gtk_drag_grab_broken_event_cb (GtkWidget          *widget,
4298                                GdkEventGrabBroken *event,
4299                                gpointer            data)
4300 {
4301   GtkDragSourceInfo *info = (GtkDragSourceInfo *)data;
4302
4303   /* Don't cancel if we break the implicit grab from the initial button_press.
4304    * Also, don't cancel if we re-grab on the widget or on our IPC window, for
4305    * example, when changing the drag cursor.
4306    */
4307   if (event->implicit
4308       || event->grab_window == info->widget->window
4309       || event->grab_window == info->ipc_widget->window)
4310     return FALSE;
4311
4312   gtk_drag_cancel (info, GTK_DRAG_RESULT_GRAB_BROKEN, gtk_get_current_event_time ());
4313   return TRUE;
4314 }
4315
4316 static void
4317 gtk_drag_grab_notify_cb (GtkWidget        *widget,
4318                          gboolean          was_grabbed,
4319                          gpointer          data)
4320 {
4321   GtkDragSourceInfo *info = (GtkDragSourceInfo *)data;
4322
4323   if (!was_grabbed)
4324     {
4325       /* We have to block callbacks to avoid recursion here, because
4326          gtk_drag_cancel calls gtk_grab_remove (via gtk_drag_end) */
4327       g_signal_handlers_block_by_func (widget, gtk_drag_grab_notify_cb, data);
4328       gtk_drag_cancel (info, GTK_DRAG_RESULT_GRAB_BROKEN, gtk_get_current_event_time ());
4329       g_signal_handlers_unblock_by_func (widget, gtk_drag_grab_notify_cb, data);
4330     }
4331 }
4332
4333
4334 /*************************************************************
4335  * gtk_drag_button_release_cb:
4336  *     "button-release-event" callback during drag.
4337  *   arguments:
4338  *
4339  *   results:
4340  *************************************************************/
4341
4342 static gboolean
4343 gtk_drag_button_release_cb (GtkWidget      *widget,
4344                             GdkEventButton *event,
4345                             gpointer        data)
4346 {
4347   GtkDragSourceInfo *info = (GtkDragSourceInfo *)data;
4348
4349   if (event->button != info->button)
4350     return FALSE;
4351
4352   if ((info->context->action != 0) && (info->context->dest_window != NULL))
4353     {
4354       gtk_drag_end (info, event->time);
4355       gtk_drag_drop (info, event->time);
4356     }
4357   else
4358     {
4359       gtk_drag_cancel (info, GTK_DRAG_RESULT_NO_TARGET, event->time);
4360     }
4361
4362   return TRUE;
4363 }
4364
4365 static gboolean
4366 gtk_drag_abort_timeout (gpointer data)
4367 {
4368   GtkDragSourceInfo *info = data;
4369   guint32 time = GDK_CURRENT_TIME;
4370
4371   if (info->proxy_dest)
4372     time = info->proxy_dest->proxy_drop_time;
4373
4374   info->drop_timeout = 0;
4375   gtk_drag_drop_finished (info, GTK_DRAG_RESULT_TIMEOUT_EXPIRED, time);
4376
4377   return FALSE;
4378 }
4379
4380 /**
4381  * gtk_drag_check_threshold:
4382  * @widget: a #GtkWidget
4383  * @start_x: X coordinate of start of drag
4384  * @start_y: Y coordinate of start of drag
4385  * @current_x: current X coordinate
4386  * @current_y: current Y coordinate
4387  *
4388  * Checks to see if a mouse drag starting at (@start_x, @start_y) and ending
4389  * at (@current_x, @current_y) has passed the GTK+ drag threshold, and thus
4390  * should trigger the beginning of a drag-and-drop operation.
4391  *
4392  * Return Value: %TRUE if the drag threshold has been passed.
4393  **/
4394 gboolean
4395 gtk_drag_check_threshold (GtkWidget *widget,
4396                           gint       start_x,
4397                           gint       start_y,
4398                           gint       current_x,
4399                           gint       current_y)
4400 {
4401   gint drag_threshold;
4402
4403   g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
4404
4405   g_object_get (gtk_widget_get_settings (widget),
4406                 "gtk-dnd-drag-threshold", &drag_threshold,
4407                 NULL);
4408
4409   return (ABS (current_x - start_x) > drag_threshold ||
4410           ABS (current_y - start_y) > drag_threshold);
4411 }
4412
4413 #define __GTK_DND_C__
4414 #include "gtkaliasdef.c"