forked from AuroraMiddleware/gtk
a411959c91
This is a huge reorganization of GtkDropTarget. I did not know how to split this up, so it's unfortunately all one commit. Highlights: - Split GtkDropTarget into GtkDropTarget and GtkDropTargetAsync GtkDropTarget is the simple one that only works with GTypes and offers a synchronous interface. GtkDropTargetAsync retains the full old functionality and allows handling mime types. - Drop events are handled differently Instead of picking a single drop target and sending all DND events to it, every event is sent to every drop target. The first one to handle the event gets to call gdk_drop_status(), further handlers do not interact with the GdkDrop. Of course, for the ultimate GDK_DROP_STARTING event, only the first one to accept the drop gets to handle it. This allows stacking DND event controllers that aren't necessarily interested in handling the event or that might decide later to drop it. - Port all widgets to either of those Both have a somewhat changed API due to the new event handling. For the ones who should use the sync version, lots of cleanup was involved to operate on a sync API.
87 lines
3.5 KiB
C
87 lines
3.5 KiB
C
/*
|
|
* Copyright © 2020 Benjamin Otte
|
|
*
|
|
* 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.1 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, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Authors: Benjamin Otte <otte@gnome.org>
|
|
*/
|
|
|
|
#ifndef __GTK_DROP_TARGET_H__
|
|
#define __GTK_DROP_TARGET_H__
|
|
|
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gtk/gtktypes.h>
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _GtkDropTarget GtkDropTarget;
|
|
|
|
|
|
#define GTK_TYPE_DROP_TARGET (gtk_drop_target_get_type ())
|
|
#define GTK_DROP_TARGET(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GTK_TYPE_DROP_TARGET, GtkDropTarget))
|
|
#define GTK_DROP_TARGET_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), GTK_TYPE_DROP_TARGET, GtkDropTargetClass))
|
|
#define GTK_IS_DROP_TARGET(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_DROP_TARGET))
|
|
#define GTK_IS_DROP_TARGET_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GTK_TYPE_DROP_TARGET))
|
|
#define GTK_DROP_TARGET_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), GTK_TYPE_DROP_TARGET, GtkDropTargetClass))
|
|
|
|
typedef struct _GtkDropTargetClass GtkDropTargetClass;
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GType gtk_drop_target_get_type (void) G_GNUC_CONST;
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GtkDropTarget * gtk_drop_target_new (GType type,
|
|
GdkDragAction actions);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_drop_target_set_gtypes (GtkDropTarget *self,
|
|
GType *types,
|
|
gsize n_types);
|
|
GDK_AVAILABLE_IN_ALL
|
|
const GType * gtk_drop_target_get_gtypes (GtkDropTarget *self,
|
|
gsize *n_types);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkContentFormats * gtk_drop_target_get_formats (GtkDropTarget *self);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_drop_target_set_actions (GtkDropTarget *self,
|
|
GdkDragAction actions);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDragAction gtk_drop_target_get_actions (GtkDropTarget *self);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_drop_target_set_preload (GtkDropTarget *self,
|
|
gboolean preload);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_drop_target_get_preload (GtkDropTarget *self);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDrop * gtk_drop_target_get_drop (GtkDropTarget *self);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
const GValue * gtk_drop_target_get_value (GtkDropTarget *self);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_drop_target_reject (GtkDropTarget *self);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GTK_DROP_TARGET_H__ */
|