1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
Drag and Drop
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2000-02-02 03:23:11 +00:00
|
|
|
functions for controlling drag and drop handling.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2000-02-02 03:23:11 +00:00
|
|
|
These functions provide a low level interface for drag and drop.
|
2001-11-28 23:41:12 +00:00
|
|
|
The X backend of GDK supports both the Xdnd and Motif drag and drop protocols
|
|
|
|
transparently, the Win32 backend supports the WM_DROPFILES protocol.
|
2000-02-02 03:23:11 +00:00
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
GTK+ provides a higher level abstraction based on top of these functions,
|
|
|
|
and so they are not normally needed in GTK+ applications.
|
|
|
|
See the <link linkend="gtk-Drag-and-Drop">Drag and Drop</link> section of
|
|
|
|
the GTK+ documentation for more information.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_get_selection ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_abort ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@time:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drop_reply ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@ok:
|
|
|
|
@time:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_context_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_drop ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@time:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_find_window ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@drag_window:
|
|
|
|
@x_root:
|
|
|
|
@y_root:
|
|
|
|
@dest_window:
|
|
|
|
@protocol:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_context_ref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_begin ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@window:
|
|
|
|
@targets:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_motion ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@dest_window:
|
|
|
|
@protocol:
|
|
|
|
@x_root:
|
|
|
|
@y_root:
|
|
|
|
@suggested_action:
|
|
|
|
@possible_actions:
|
|
|
|
@time:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drop_finish ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@success:
|
|
|
|
@time:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_get_protocol ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@xid:
|
|
|
|
@protocol:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### ENUM GdkDragProtocol ##### -->
|
|
|
|
<para>
|
2001-11-28 23:41:12 +00:00
|
|
|
Is used in #GdkDragContext to indicate the protocol according to
|
|
|
|
which DND is done.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-11-28 23:41:12 +00:00
|
|
|
@GDK_DRAG_PROTO_MOTIF: The Motif DND protocol.
|
|
|
|
@GDK_DRAG_PROTO_XDND: The Xdnd protocol.
|
|
|
|
@GDK_DRAG_PROTO_ROOTWIN: An extension to the Xdnd protocol for
|
|
|
|
unclaimed root window drops.
|
|
|
|
@GDK_DRAG_PROTO_NONE: no protocol.
|
|
|
|
@GDK_DRAG_PROTO_WIN32_DROPFILES: The simple WM_DROPFILES protocol.
|
|
|
|
@GDK_DRAG_PROTO_OLE2: The complex OLE2 DND protocol (not implemented).
|
|
|
|
@GDK_DRAG_PROTO_LOCAL: Intra-application DND.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_context_unref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GdkDragContext ##### -->
|
|
|
|
<para>
|
2001-11-28 23:41:12 +00:00
|
|
|
A <structname>GdkDragContext</structname> holds information about a
|
|
|
|
drag in progress. It is used on both source and destination sides.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2001-11-28 23:41:12 +00:00
|
|
|
@parent_instance:
|
|
|
|
@protocol: the DND protocol which governs this drag.
|
|
|
|
@is_source: %TRUE if the context is used on the source side.
|
|
|
|
@source_window: the source of this drag.
|
|
|
|
@dest_window: the destination window of this drag.
|
|
|
|
@targets: a list of targets accepted on the destination.
|
|
|
|
@actions: a bitmask of all possible actions.
|
|
|
|
@suggested_action: the suggested action.
|
1999-08-16 18:51:52 +00:00
|
|
|
@action:
|
2001-11-28 23:41:12 +00:00
|
|
|
@start_time: a timestamp recording the start time of this drag.
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### ENUM GdkDragAction ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@GDK_ACTION_DEFAULT:
|
|
|
|
@GDK_ACTION_COPY:
|
|
|
|
@GDK_ACTION_MOVE:
|
|
|
|
@GDK_ACTION_LINK:
|
|
|
|
@GDK_ACTION_PRIVATE:
|
|
|
|
@GDK_ACTION_ASK:
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_drag_status ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@context:
|
|
|
|
@action:
|
|
|
|
@time:
|
|
|
|
|
|
|
|
|