1/* GDK - The GIMP Drawing Kit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
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.
8 *
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.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18/*
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 */
24
25#ifndef __GDK_DND_H__
26#define __GDK_DND_H__
27
28#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
29#error "Only <gdk/gdk.h> can be included directly."
30#endif
31
32#include <gdk/gdkdevice.h>
33#include <gdk/gdkenums.h>
34#include <gdk/gdkevents.h>
35#include <gdk/gdktypes.h>
36
37G_BEGIN_DECLS
38
39#define GDK_TYPE_DRAG (gdk_drag_get_type ())
40#define GDK_DRAG(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DRAG, GdkDrag))
41#define GDK_IS_DRAG(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DRAG))
42
43/**
44 * GdkDragCancelReason:
45 * @GDK_DRAG_CANCEL_NO_TARGET: There is no suitable drop target.
46 * @GDK_DRAG_CANCEL_USER_CANCELLED: Drag cancelled by the user
47 * @GDK_DRAG_CANCEL_ERROR: Unspecified error.
48 *
49 * Used in `GdkDrag` to the reason of a cancelled DND operation.
50 */
51typedef enum {
52 GDK_DRAG_CANCEL_NO_TARGET,
53 GDK_DRAG_CANCEL_USER_CANCELLED,
54 GDK_DRAG_CANCEL_ERROR
55} GdkDragCancelReason;
56
57GDK_AVAILABLE_IN_ALL
58GType gdk_drag_get_type (void) G_GNUC_CONST;
59
60GDK_AVAILABLE_IN_ALL
61GdkDisplay * gdk_drag_get_display (GdkDrag *drag);
62GDK_AVAILABLE_IN_ALL
63GdkDevice * gdk_drag_get_device (GdkDrag *drag);
64
65GDK_AVAILABLE_IN_ALL
66GdkContentFormats *gdk_drag_get_formats (GdkDrag *drag);
67GDK_AVAILABLE_IN_ALL
68GdkDragAction gdk_drag_get_actions (GdkDrag *drag);
69GDK_AVAILABLE_IN_ALL
70GdkDragAction gdk_drag_get_selected_action (GdkDrag *drag);
71
72GDK_AVAILABLE_IN_ALL
73gboolean gdk_drag_action_is_unique (GdkDragAction action) G_GNUC_CONST;
74
75GDK_AVAILABLE_IN_ALL
76GdkDrag * gdk_drag_begin (GdkSurface *surface,
77 GdkDevice *device,
78 GdkContentProvider *content,
79 GdkDragAction actions,
80 double dx,
81 double dy);
82
83GDK_AVAILABLE_IN_ALL
84void gdk_drag_drop_done (GdkDrag *drag,
85 gboolean success);
86
87GDK_AVAILABLE_IN_ALL
88GdkSurface *gdk_drag_get_drag_surface (GdkDrag *drag);
89
90GDK_AVAILABLE_IN_ALL
91void gdk_drag_set_hotspot (GdkDrag *drag,
92 int hot_x,
93 int hot_y);
94
95GDK_AVAILABLE_IN_ALL
96GdkContentProvider *
97 gdk_drag_get_content (GdkDrag *drag);
98
99GDK_AVAILABLE_IN_ALL
100GdkSurface * gdk_drag_get_surface (GdkDrag *drag);
101
102G_END_DECLS
103
104#endif /* __GDK_DND_H__ */
105

source code of gtk/gdk/gdkdrag.h