Package org.gnome.gtk

Class DragSource

java.lang.Object
org.javagi.base.ProxyInstance
org.gnome.gobject.TypeInstance
org.gnome.gobject.GObject
org.gnome.gtk.EventController
org.gnome.gtk.Gesture
org.gnome.gtk.GestureSingle
org.gnome.gtk.DragSource
All Implemented Interfaces:
Proxy
@Generated("io.github.jwharm.JavaGI") public class DragSource extends GestureSingle
An event controller to initiate Drag-And-Drop operations.

GtkDragSource can be set up with the necessary ingredients for a DND operation ahead of time. This includes the source for the data that is being transferred, in the form of a ContentProvider, the desired action, and the icon to use during the drag operation. After setting it up, the drag source must be added to a widget as an event controller, using Widget.addController(org.gnome.gtk.EventController). 

static void
 my_widget_init (MyWidget *self)
 {
   GtkDragSource *drag_source = gtk_drag_source_new ();

   g_signal_connect (drag_source, "prepare", G_CALLBACK (on_drag_prepare), self);
   g_signal_connect (drag_source, "drag-begin", G_CALLBACK (on_drag_begin), self);

   gtk_widget_add_controller (GTK_WIDGET (self), GTK_EVENT_CONTROLLER (drag_source));
 }

Setting up the content provider and icon ahead of time only makes sense when the data does not change. More commonly, you will want to set them up just in time. To do so, GtkDragSource has Gtk.DragSource::prepare and Gtk.DragSource::drag-begin signals.

The ::prepare signal is emitted before a drag is started, and can be used to set the content provider and actions that the drag should be started with. 

static GdkContentProvider *
 on_drag_prepare (GtkDragSource *source,
                  double         x,
                  double         y,
                  MyWidget      *self)
 {
   // This widget supports two types of content: GFile objects
   // and GdkPixbuf objects; GTK will handle the serialization
   // of these types automatically
   GFile *file = my_widget_get_file (self);
   GdkPixbuf *pixbuf = my_widget_get_pixbuf (self);

   return gdk_content_provider_new_union ((GdkContentProvider *[2]) {
       gdk_content_provider_new_typed (G_TYPE_FILE, file),
       gdk_content_provider_new_typed (GDK_TYPE_PIXBUF, pixbuf),
     }, 2);
 }

The ::drag-begin signal is emitted after the GdkDrag object has been created, and can be used to set up the drag icon. 

static void
 on_drag_begin (GtkDragSource *source,
                GdkDrag       *drag,
                MyWidget      *self)
 {
   // Set the widget as the drag icon
   GdkPaintable *paintable = gtk_widget_paintable_new (GTK_WIDGET (self));
   gtk_drag_source_set_icon (source, paintable, 0, 0);
   g_object_unref (paintable);
 }

During the DND operation, GtkDragSource emits signals that can be used to obtain updates about the status of the operation, but it is not normally necessary to connect to any signals, except for one case: when the supported actions include DragAction.MOVE, you need to listen for the Gtk.DragSource::drag-end signal and delete the data after it has been transferred.