Package: gdk

Class gdk:drag-context

Superclasses

gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

None

Details

The gdk:drag-context class and the correspondig functions provide a low level interface for drag and drop. The X backend of GDK supports both the Xdnd and Motif drag and drop protocols transparently, the Win32 backend supports the WM_DROPFILES protocol.

GTK provides a higher level abstraction based on top of these functions, and so they are not normally needed in GTK applications. See the Drag and Drop section of the GTK documentation for more information.

Signal Details

The "action-changed" signal 
 lambda (context action)    :run-last
context
The gdk:drag-context object on which the signal is emitted.
action
The gdk:drag-action value currently chosen.
A new action is being chosen for the drag and drop operation. The signal will only be emitted if the gtk-drag-context object manages the drag and drop operation. See the gdk:drag-context-manage-dnd function for more information. Since 3.20
The "cancel" signal 
 lambda (context reason)    :run-last
context
The gdk:drag-context object on which the signal is emitted.
reason
The gdk:drag-cancel-reason value the drag context was cancelled.
The drag and drop operation was cancelled. The signal will only be emitted if the gdk:drag-context object manages the drag and drop operation. See the gdk:drag-context-manage-dnd function for more information. Since 3.20
The "dnd-finished" signal 
 lambda (context)    :run-last
context
The gdk:drag-context object on which the signal is emitted.
The drag and drop operation was finished, the drag destination finished reading all data. The drag source can now free all miscellaneous data. This signal will only be emitted if the gdk:drag-context object manages the drag and drop operation. See the gdk:drag-context-manage-dnd function for more information. Since 3.20
The "drop-performed" signal 
 lambda (context time)    :run-last
context
The gdk:drag-context object on which the signal is emitted.
time
The integer for the time at which the drop happened.
The drag and drop operation was performed on an accepting client. This signal will only be emitted if the gdk:drag-context object manages the drag and drop operation. See the gdk:drag-context-manage-dnd function for more information. Since 3.20
 

Inherited Slot Access Functions

g:object-has-reference
g:object-pointer

See also

gdk:drag-cancel-reason
gdk:drag-protocol
gdk:drag-action
gdk:drag-context-manage-dnd
2025-07-17