Drag.begin

Starts a drag and creates a new drag context for it.

This function is called by the drag source. After this call, you probably want to set up the drag icon using the surface returned by gdk.drag.Drag.getDragSurface.

This function returns a reference to the gdk.drag.Drag object, but GTK keeps its own reference as well, as long as the DND operation is going on.

Note: if actions include gdk.types.DragAction.Move, you need to listen for the signalGdk.Drag::dnd-finished signal and delete the data at the source if gdk.drag.Drag.getSelectedAction returns gdk.types.DragAction.Move.

Parameters

surface gdk.surface.Surface

the source surface for this drag

device gdk.device.Device

the device that controls this drag

content gdk.content_provider.ContentProvider

the offered content

actions gdk.types.DragAction

the actions supported by this drag

dx double

the x offset to device's position where the drag nominally started

dy double

the y offset to device's position where the drag nominally started

Return Value

Type: gdk.drag.Drag

a newly created gdk.drag.Drag