gdk-Drag-and-Drop: Drag and Drop
Description
Functions for controlling drag and drop handlingMethods 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.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.