AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-28 22:41:43 +00:00
Code Issues Projects Releases Wiki Activity
6819c7c792
gtk/gdk/gdkdragprivate.h

87 lines
3.4 KiB
C
Raw Normal View History

Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
/* GDK - The GIMP Drawing Kit
* Copyright (C) 2010, Red Hat, Inc
*
* 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
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
*/
#ifndef __GDK_DND_PRIVATE_H__
#define __GDK_DND_PRIVATE_H__
dnd: Rename headers Rename gdkdnd.h to gdkdrag.h, to go along with gdkdrop.h This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-07-02 11:39:09 +00:00
#include "gdkdrag.h"
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
G_BEGIN_DECLS
Consistently hide class structs And, since we've decided to keep the structs private, there is no point in having the standard GObject clas macros anymore either.
2010-12-24 20:54:12 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
#define GDK_DRAG_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_DRAG, GdkDragClass))
#define GDK_IS_DRAG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DRAG))
#define GDK_DRAG_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DRAG, GdkDragClass))
Consistently hide class structs And, since we've decided to keep the structs private, there is no point in having the standard GObject clas macros anymore either.
2010-12-24 20:54:12 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
typedef struct _GdkDragClass GdkDragClass;
Consistently hide class structs And, since we've decided to keep the structs private, there is no point in having the standard GObject clas macros anymore either.
2010-12-24 20:54:12 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
struct _GdkDragClass {
dnd: GdkDragContext is no longer a GdkDrop subclass This includes a bunch of header cleanup
2018-06-14 02:58:50 +00:00
GObjectClass parent_class;
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
GdkSurface* (*get_drag_surface) (GdkDrag *drag);
void (*set_hotspot) (GdkDrag *drag,
gdk: Add api to set drag window hotspot With GdkDragContext now being in charge of placing the window, it needs to know about the hotspot to place under the cursor.
2015-12-08 02:52:03 +00:00
gint hot_x,
gint hot_y);
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void (*drop_done) (GdkDrag *drag,
gdk: Add gdk_drag_drop_done This will allow us to move the drag cancel animation to GDK. For now, it does nothing.
2015-12-07 20:07:13 +00:00
gboolean success);
gdk: Allow internal management of source-side DnD We've traditionally left GTK+ to handle the input side of things, letting GDK only manage the windowing-specific messaging. This way of splitting responsibilities is not compatible however with some backends, we must fold then input management at the DnD stage into GDK (and backends) domain. The gdk_drag_context_manage_dnd() call is meant to be the entry point for this mode of operation, if the drag and drop operation becomes managed, the caller (i.e. gtkdnd.c) doesn't need to perform grabs, nor manage input events itself. As a consequence of this, different aspects now belong to the backend GdkDragContext implementation: - Because the caller doesn't see keyboard events anymore, keyboard navigation must be managed in GDK, so is the decision of the current action based on modifiers/button pressed. - Because the caller won't see input events in general, the lifetime of the drag and drop operation is now communicated through the ::drop-performed, ::dnd-finished and ::cancel events - Because the caller doesn't participate anymore on the action being chosen, the pointer cursor must be set by the backend. The caller is rather notified of the final action through the ::action signal. The caller is still responsible of dealing with the corresponding GdkSelection, ensuring its ownership and communicating the supported mimetypes.
2016-01-08 20:03:01 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void (*set_cursor) (GdkDrag *drag,
gdk: Allow internal management of source-side DnD We've traditionally left GTK+ to handle the input side of things, letting GDK only manage the windowing-specific messaging. This way of splitting responsibilities is not compatible however with some backends, we must fold then input management at the DnD stage into GDK (and backends) domain. The gdk_drag_context_manage_dnd() call is meant to be the entry point for this mode of operation, if the drag and drop operation becomes managed, the caller (i.e. gtkdnd.c) doesn't need to perform grabs, nor manage input events itself. As a consequence of this, different aspects now belong to the backend GdkDragContext implementation: - Because the caller doesn't see keyboard events anymore, keyboard navigation must be managed in GDK, so is the decision of the current action based on modifiers/button pressed. - Because the caller won't see input events in general, the lifetime of the drag and drop operation is now communicated through the ::drop-performed, ::dnd-finished and ::cancel events - Because the caller doesn't participate anymore on the action being chosen, the pointer cursor must be set by the backend. The caller is rather notified of the final action through the ::action signal. The caller is still responsible of dealing with the corresponding GdkSelection, ensuring its ownership and communicating the supported mimetypes.
2016-01-08 20:03:01 +00:00
GdkCursor *cursor);
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void (*cancel) (GdkDrag *drag,
gdk: Add GdkDragCancelReason enum as argument to GdkDragContext::cancel We should conform to a minimal set of reasons for the gtk side to emit a better GtkDragResult than GTK_DRAG_RESULT_ERROR. This fixes the notebook tab DnD feature, where we rely on GTK_DRAG_RESULT_NO_TARGET. In the wayland side, unfortunately we can't honor either NO_TARGET nor USER_CANCELLED, we don't know of the latter, so we could return false positives on the former. https://bugzilla.gnome.org/show_bug.cgi?id=761954
2016-02-15 16:02:14 +00:00
GdkDragCancelReason reason);
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void (*drop_performed) (GdkDrag *drag,
gdk: Allow internal management of source-side DnD We've traditionally left GTK+ to handle the input side of things, letting GDK only manage the windowing-specific messaging. This way of splitting responsibilities is not compatible however with some backends, we must fold then input management at the DnD stage into GDK (and backends) domain. The gdk_drag_context_manage_dnd() call is meant to be the entry point for this mode of operation, if the drag and drop operation becomes managed, the caller (i.e. gtkdnd.c) doesn't need to perform grabs, nor manage input events itself. As a consequence of this, different aspects now belong to the backend GdkDragContext implementation: - Because the caller doesn't see keyboard events anymore, keyboard navigation must be managed in GDK, so is the decision of the current action based on modifiers/button pressed. - Because the caller won't see input events in general, the lifetime of the drag and drop operation is now communicated through the ::drop-performed, ::dnd-finished and ::cancel events - Because the caller doesn't participate anymore on the action being chosen, the pointer cursor must be set by the backend. The caller is rather notified of the final action through the ::action signal. The caller is still responsible of dealing with the corresponding GdkSelection, ensuring its ownership and communicating the supported mimetypes.
2016-01-08 20:03:01 +00:00
guint32 time);
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void (*dnd_finished) (GdkDrag *drag);
gdk: Allow internal management of source-side DnD We've traditionally left GTK+ to handle the input side of things, letting GDK only manage the windowing-specific messaging. This way of splitting responsibilities is not compatible however with some backends, we must fold then input management at the DnD stage into GDK (and backends) domain. The gdk_drag_context_manage_dnd() call is meant to be the entry point for this mode of operation, if the drag and drop operation becomes managed, the caller (i.e. gtkdnd.c) doesn't need to perform grabs, nor manage input events itself. As a consequence of this, different aspects now belong to the backend GdkDragContext implementation: - Because the caller doesn't see keyboard events anymore, keyboard navigation must be managed in GDK, so is the decision of the current action based on modifiers/button pressed. - Because the caller won't see input events in general, the lifetime of the drag and drop operation is now communicated through the ::drop-performed, ::dnd-finished and ::cancel events - Because the caller doesn't participate anymore on the action being chosen, the pointer cursor must be set by the backend. The caller is rather notified of the final action through the ::action signal. The caller is still responsible of dealing with the corresponding GdkSelection, ensuring its ownership and communicating the supported mimetypes.
2016-01-08 20:03:01 +00:00
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
gboolean (*handle_event) (GdkDrag *drag,
Strip const from GdkEvent Events are refcounted structs, and we generally don't pass these as const.
2020-02-16 16:09:02 +00:00
GdkEvent *event);
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
};
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
struct _GdkDrag {
dnd: GdkDragContext is no longer a GdkDrop subclass This includes a bunch of header cleanup
2018-06-14 02:58:50 +00:00
GObject parent_instance;
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
};
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void gdk_drag_set_cursor (GdkDrag *drag,
GdkCursor *cursor);
void gdk_drag_set_actions (GdkDrag *drag,
drag: Split a setter In preparation for moving the suggested action to the x11 backend, split the setter off.
2018-07-04 06:32:27 +00:00
GdkDragAction actions);
Rename a property Change GdkDrag::action to GdkDrag::selected-action, which is more clearly different from actions, and follows the existing name of the struct field and getter.
2018-07-03 22:44:00 +00:00
void gdk_drag_set_selected_action (GdkDrag *drag,
dnd: Add a GdkDrag::action property This lets us drop the ::action-changed signal for the property change notification. But, can just as well move the signal class handers which just update the cursor to the ::action setter. No need to do this in the backends.
2018-07-02 23:16:47 +00:00
GdkDragAction action);
gdk: Rename GdkDragContext to GdkDrag This is to go along with the newly introduced GdkDrop. This commit includes the necessary updates to the X11, Wayland and Broadway backends. Other backends have to be updated separately.
2018-06-29 17:34:14 +00:00
void gdk_drag_cancel (GdkDrag *drag,
GdkDragCancelReason reason);
gboolean gdk_drag_handle_source_event (GdkEvent *event);
GdkCursor * gdk_drag_get_cursor (GdkDrag *drag,
GdkDragAction action);
void gdk_drag_write_async (GdkDrag *drag,
const char *mime_type,
GOutputStream *stream,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
gboolean gdk_drag_write_finish (GdkDrag *drag,
GAsyncResult *result,
GError **error);
Drop api that is only for unmanaged dnd These functions are not needed as public api anymore.
2017-08-24 18:30:47 +00:00
Explode gdkinternals.h into per-class private headers At the same time, move some more class and instance structs out of public headers.
2010-12-11 05:14:53 +00:00
G_END_DECLS
#endif
Reference in New Issue Copy Permalink