forked from AuroraMiddleware/gtk
c53ec081ce
This commit hides GdkDragContext and GdkDragContextClass, adds vfuncs for most drag context functionality, and turns the X11 DND implementation into GdkDragContextX11. We also add vfuncs to GdkDisplay for gdk_drag_get_protocol and to GdkWindow for gdk_drag_begin, and implemenet them for X11. Other backends need similar treatment and are broken now.
170 lines
6.6 KiB
C
170 lines
6.6 KiB
C
/* GDK - The GIMP Drawing Kit
|
|
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
|
* file for a list of people on the GTK+ Team. See the ChangeLog
|
|
* files for a list of changes. These files are distributed with
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
|
*/
|
|
|
|
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
|
|
#error "Only <gdk/gdk.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __GDK_DND_H__
|
|
#define __GDK_DND_H__
|
|
|
|
#include <gdk/gdktypes.h>
|
|
#include <gdk/gdkdevice.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* Object that holds information about a drag in progress.
|
|
* this is used on both source and destination sides.
|
|
*/
|
|
typedef struct _GdkDragContext GdkDragContext;
|
|
typedef struct _GdkDragContextClass GdkDragContextClass;
|
|
|
|
/**
|
|
* GdkDragAction:
|
|
* @GDK_ACTION_DEFAULT: Means nothing, and should not be used.
|
|
* @GDK_ACTION_COPY: Copy the data.
|
|
* @GDK_ACTION_MOVE: Move the data, i.e. first copy it, then delete
|
|
* it from the source using the DELETE target of the X selection protocol.
|
|
* @GDK_ACTION_LINK: Add a link to the data. Note that this is only
|
|
* useful if source and destination agree on what it means.
|
|
* @GDK_ACTION_PRIVATE: Special action which tells the source that the
|
|
* destination will do something that the source doesn't understand.
|
|
* @GDK_ACTION_ASK: Ask the user what to do with the data.
|
|
*
|
|
* Used in #GdkDragContext to indicate what the destination
|
|
* should do with the dropped data.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_ACTION_DEFAULT = 1 << 0,
|
|
GDK_ACTION_COPY = 1 << 1,
|
|
GDK_ACTION_MOVE = 1 << 2,
|
|
GDK_ACTION_LINK = 1 << 3,
|
|
GDK_ACTION_PRIVATE = 1 << 4,
|
|
GDK_ACTION_ASK = 1 << 5
|
|
} GdkDragAction;
|
|
|
|
/**
|
|
* GdkDragProtocol:
|
|
* @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.
|
|
*
|
|
* Used in #GdkDragContext to indicate the protocol according to
|
|
* which DND is done.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_DRAG_PROTO_MOTIF,
|
|
GDK_DRAG_PROTO_XDND,
|
|
GDK_DRAG_PROTO_ROOTWIN,
|
|
GDK_DRAG_PROTO_NONE,
|
|
GDK_DRAG_PROTO_WIN32_DROPFILES,
|
|
GDK_DRAG_PROTO_OLE2,
|
|
GDK_DRAG_PROTO_LOCAL
|
|
} GdkDragProtocol;
|
|
|
|
|
|
#define GDK_TYPE_DRAG_CONTEXT (gdk_drag_context_get_type ())
|
|
#define GDK_DRAG_CONTEXT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DRAG_CONTEXT, GdkDragContext))
|
|
#define GDK_DRAG_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_DRAG_CONTEXT, GdkDragContextClass))
|
|
#define GDK_IS_DRAG_CONTEXT(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DRAG_CONTEXT))
|
|
#define GDK_IS_DRAG_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DRAG_CONTEXT))
|
|
#define GDK_DRAG_CONTEXT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DRAG_CONTEXT, GdkDragContextClass))
|
|
|
|
|
|
GType gdk_drag_context_get_type (void) G_GNUC_CONST;
|
|
|
|
void gdk_drag_context_set_device (GdkDragContext *context,
|
|
GdkDevice *device);
|
|
GdkDevice * gdk_drag_context_get_device (GdkDragContext *context);
|
|
|
|
GList *gdk_drag_context_list_targets (GdkDragContext *context);
|
|
GdkDragAction gdk_drag_context_get_actions (GdkDragContext *context);
|
|
GdkDragAction gdk_drag_context_get_suggested_action (GdkDragContext *context);
|
|
GdkDragAction gdk_drag_context_get_selected_action (GdkDragContext *context);
|
|
|
|
GdkWindow *gdk_drag_context_get_source_window (GdkDragContext *context);
|
|
GdkWindow *gdk_drag_context_get_dest_window (GdkDragContext *context);
|
|
GdkDragProtocol gdk_drag_context_get_protocol (GdkDragContext *context);
|
|
|
|
/* Destination side */
|
|
|
|
void gdk_drag_status (GdkDragContext *context,
|
|
GdkDragAction action,
|
|
guint32 time_);
|
|
void gdk_drop_reply (GdkDragContext *context,
|
|
gboolean ok,
|
|
guint32 time_);
|
|
void gdk_drop_finish (GdkDragContext *context,
|
|
gboolean success,
|
|
guint32 time_);
|
|
GdkAtom gdk_drag_get_selection (GdkDragContext *context);
|
|
|
|
/* Source side */
|
|
|
|
GdkDragContext * gdk_drag_begin (GdkWindow *window,
|
|
GList *targets);
|
|
|
|
GdkDragContext * gdk_drag_begin_for_device (GdkWindow *window,
|
|
GdkDevice *device,
|
|
GList *targets);
|
|
|
|
GdkNativeWindow gdk_drag_get_protocol_for_display (GdkDisplay *display,
|
|
GdkNativeWindow xid,
|
|
GdkDragProtocol *protocol);
|
|
|
|
void gdk_drag_find_window_for_screen (GdkDragContext *context,
|
|
GdkWindow *drag_window,
|
|
GdkScreen *screen,
|
|
gint x_root,
|
|
gint y_root,
|
|
GdkWindow **dest_window,
|
|
GdkDragProtocol *protocol);
|
|
|
|
gboolean gdk_drag_motion (GdkDragContext *context,
|
|
GdkWindow *dest_window,
|
|
GdkDragProtocol protocol,
|
|
gint x_root,
|
|
gint y_root,
|
|
GdkDragAction suggested_action,
|
|
GdkDragAction possible_actions,
|
|
guint32 time_);
|
|
void gdk_drag_drop (GdkDragContext *context,
|
|
guint32 time_);
|
|
void gdk_drag_abort (GdkDragContext *context,
|
|
guint32 time_);
|
|
gboolean gdk_drag_drop_succeeded (GdkDragContext *context);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GDK_DND_H__ */
|