mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-25 21:21:21 +00:00
209 lines
7.3 KiB
C
209 lines
7.3 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
|
|
|
|
typedef struct _GdkDragContext GdkDragContext;
|
|
|
|
/**
|
|
* 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, /* A root window with nobody claiming
|
|
* drags */
|
|
GDK_DRAG_PROTO_NONE, /* Not a valid drag window */
|
|
GDK_DRAG_PROTO_WIN32_DROPFILES, /* The simple WM_DROPFILES dnd */
|
|
GDK_DRAG_PROTO_OLE2, /* The complex OLE2 dnd (not implemented) */
|
|
GDK_DRAG_PROTO_LOCAL /* Intra-app */
|
|
} GdkDragProtocol;
|
|
|
|
/* Object that holds information about a drag in progress.
|
|
* this is used on both source and destination sides.
|
|
*/
|
|
|
|
typedef struct _GdkDragContextClass GdkDragContextClass;
|
|
|
|
#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))
|
|
|
|
struct _GdkDragContext {
|
|
GObject parent_instance;
|
|
|
|
/*< public >*/
|
|
|
|
GdkDragProtocol GSEAL (protocol);
|
|
|
|
gboolean GSEAL (is_source);
|
|
|
|
GdkWindow *GSEAL (source_window);
|
|
GdkWindow *GSEAL (dest_window);
|
|
|
|
GList *GSEAL (targets);
|
|
GdkDragAction GSEAL (actions);
|
|
GdkDragAction GSEAL (suggested_action);
|
|
GdkDragAction GSEAL (action);
|
|
|
|
guint32 GSEAL (start_time);
|
|
|
|
/*< private >*/
|
|
|
|
gpointer GSEAL (windowing_data);
|
|
};
|
|
|
|
struct _GdkDragContextClass {
|
|
GObjectClass parent_class;
|
|
|
|
};
|
|
|
|
/* Drag and Drop */
|
|
|
|
GType gdk_drag_context_get_type (void) G_GNUC_CONST;
|
|
GdkDragContext * gdk_drag_context_new (void);
|
|
|
|
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);
|
|
|
|
/* 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);
|
|
|
|
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);
|
|
|
|
#ifndef GDK_MULTIHEAD_SAFE
|
|
GdkNativeWindow gdk_drag_get_protocol (GdkNativeWindow xid,
|
|
GdkDragProtocol *protocol);
|
|
|
|
void gdk_drag_find_window (GdkDragContext *context,
|
|
GdkWindow *drag_window,
|
|
gint x_root,
|
|
gint y_root,
|
|
GdkWindow **dest_window,
|
|
GdkDragProtocol *protocol);
|
|
#endif /* GDK_MULTIHEAD_SAFE */
|
|
|
|
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__ */
|