gdk-Drag-and-Drop: Drag and Drop

Description

Functions for controlling drag and drop handling

Arguments

Methods and Functions

gdkDragGetSelection(object) gdkDragAbort(object, time) gdkDropReply(object, ok, time = "GDK_CURRENT_TIME") gdkDragContextNew() gdkDragDrop(object, time) gdkDragFindWindow(object, drag.window, x.root, y.root) gdkDragFindWindowForScreen(object, drag.window, screen, x.root, y.root) gdkDragBegin(object, targets) gdkDragMotion(object, dest.window, protocol, x.root, y.root, suggested.action, possible.actions, time) gdkDropFinish(object, success, time = "GDK_CURRENT_TIME") gdkDragGetProtocol(xid) gdkDragGetProtocolForDisplay(display, xid) gdkDragStatus(object, action, time = "GDK_CURRENT_TIME") gdkDragDropSucceeded(object) gdkDragContext()

Detailed Description

These 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.

Structures

Convenient Construction

gdkDragContext is the equivalent of gdkDragContextNew.

Enums and Flags

GdkDragProtocol

Used in GdkDragContext to indicate the protocol according to which DND is done.

motif: The Motif DND protocol.
xdnd: The Xdnd protocol.
rootwin: An extension to the Xdnd protocol for unclaimed root window drops.
none: no protocol.
win32-dropfiles: The simple WM_DROPFILES protocol.
ole2: The complex OLE2 DND protocol (not implemented).
local: Intra-application DND.

GdkDragAction

Used in GdkDragContext to indicate what the destination should do with the dropped data.

default: Means nothing, and should not be used.
copy: Copy the data.
move: Move the data, i.e. first copy it, then delete it from the source using the DELETE target of the X selection protocol.
link: Add a link to the data. Note that this is only useful if source and destination agree on what it means.
private: Special action which tells the source that the destination will do something that the source doesn't understand.
ask: Ask the user what to do with the data.

References

http://library.gnome.org/devel//gdk/gdk-Drag-and-Drop.html

State of Data and AI Literacy Report 2025