1 /* GDK - The GIMP Drawing Kit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
27 #if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
28 #error "Only <gdk/gdk.h> can be included directly."
34 #include <gdk/gdktypes.h>
35 #include <gdk/gdkdevice.h>
39 #define GDK_TYPE_DRAG_CONTEXT (gdk_drag_context_get_type ())
40 #define GDK_DRAG_CONTEXT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DRAG_CONTEXT, GdkDragContext))
41 #define GDK_IS_DRAG_CONTEXT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DRAG_CONTEXT))
45 * @GDK_ACTION_DEFAULT: Means nothing, and should not be used.
46 * @GDK_ACTION_COPY: Copy the data.
47 * @GDK_ACTION_MOVE: Move the data, i.e. first copy it, then delete
48 * it from the source using the DELETE target of the X selection protocol.
49 * @GDK_ACTION_LINK: Add a link to the data. Note that this is only
50 * useful if source and destination agree on what it means.
51 * @GDK_ACTION_PRIVATE: Special action which tells the source that the
52 * destination will do something that the source doesn't understand.
53 * @GDK_ACTION_ASK: Ask the user what to do with the data.
55 * Used in #GdkDragContext to indicate what the destination
56 * should do with the dropped data.
60 GDK_ACTION_DEFAULT = 1 << 0,
61 GDK_ACTION_COPY = 1 << 1,
62 GDK_ACTION_MOVE = 1 << 2,
63 GDK_ACTION_LINK = 1 << 3,
64 GDK_ACTION_PRIVATE = 1 << 4,
65 GDK_ACTION_ASK = 1 << 5
70 * @GDK_DRAG_PROTO_NONE: no protocol.
71 * @GDK_DRAG_PROTO_MOTIF: The Motif DND protocol.
72 * @GDK_DRAG_PROTO_XDND: The Xdnd protocol.
73 * @GDK_DRAG_PROTO_ROOTWIN: An extension to the Xdnd protocol for
74 * unclaimed root window drops.
75 * @GDK_DRAG_PROTO_WIN32_DROPFILES: The simple WM_DROPFILES protocol.
76 * @GDK_DRAG_PROTO_OLE2: The complex OLE2 DND protocol (not implemented).
77 * @GDK_DRAG_PROTO_LOCAL: Intra-application DND.
79 * Used in #GdkDragContext to indicate the protocol according to
84 GDK_DRAG_PROTO_NONE = 0,
87 GDK_DRAG_PROTO_ROOTWIN,
88 GDK_DRAG_PROTO_WIN32_DROPFILES,
94 GType gdk_drag_context_get_type (void) G_GNUC_CONST;
96 void gdk_drag_context_set_device (GdkDragContext *context,
98 GdkDevice * gdk_drag_context_get_device (GdkDragContext *context);
100 GList *gdk_drag_context_list_targets (GdkDragContext *context);
101 GdkDragAction gdk_drag_context_get_actions (GdkDragContext *context);
102 GdkDragAction gdk_drag_context_get_suggested_action (GdkDragContext *context);
103 GdkDragAction gdk_drag_context_get_selected_action (GdkDragContext *context);
105 GdkWindow *gdk_drag_context_get_source_window (GdkDragContext *context);
106 GdkWindow *gdk_drag_context_get_dest_window (GdkDragContext *context);
107 GdkDragProtocol gdk_drag_context_get_protocol (GdkDragContext *context);
109 /* Destination side */
111 void gdk_drag_status (GdkDragContext *context,
112 GdkDragAction action,
114 void gdk_drop_reply (GdkDragContext *context,
117 void gdk_drop_finish (GdkDragContext *context,
120 GdkAtom gdk_drag_get_selection (GdkDragContext *context);
124 GdkDragContext * gdk_drag_begin (GdkWindow *window,
127 GdkDragContext * gdk_drag_begin_for_device (GdkWindow *window,
131 void gdk_drag_find_window_for_screen (GdkDragContext *context,
132 GdkWindow *drag_window,
136 GdkWindow **dest_window,
137 GdkDragProtocol *protocol);
139 gboolean gdk_drag_motion (GdkDragContext *context,
140 GdkWindow *dest_window,
141 GdkDragProtocol protocol,
144 GdkDragAction suggested_action,
145 GdkDragAction possible_actions,
147 void gdk_drag_drop (GdkDragContext *context,
149 void gdk_drag_abort (GdkDragContext *context,
151 gboolean gdk_drag_drop_succeeded (GdkDragContext *context);
155 #endif /* __GDK_DND_H__ */