summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarlos Garnacho <carlosg@gnome.org>2016-01-18 22:22:24 +0100
committerCarlos Garnacho <carlosg@gnome.org>2016-01-19 00:00:06 +0100
commit5afe78cf99c2cf75620a29664945ab265df8e42b (patch)
treee174e7ea244eb3b523de299f6befcc0924908c8e
parentbe016ad7454f446f8b28cedb3412cd8fe636dd19 (diff)
downloadgtk+-5afe78cf99c2cf75620a29664945ab265df8e42b.tar.gz
gdk: Document the functions that don't need calling on managed DnD
These functions will be automatically called by the windowing backend. The usual hooks to run this from in gtk/ shouldn't even happen, but it is worth to document which calls are expected and which aren't.
-rw-r--r--gdk/gdkdnd.c9
1 files changed, 9 insertions, 0 deletions
diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c
index 5803e9f4b8..0a3afea680 100644
--- a/gdk/gdkdnd.c
+++ b/gdk/gdkdnd.c
@@ -428,6 +428,9 @@ gdk_drag_status (GdkDragContext *context,
*
* This function is called by the drag source.
*
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
+ *
* Returns:
*/
gboolean
@@ -461,6 +464,9 @@ gdk_drag_motion (GdkDragContext *context,
* Aborts a drag without dropping.
*
* This function is called by the drag source.
+ *
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
*/
void
gdk_drag_abort (GdkDragContext *context,
@@ -479,6 +485,9 @@ gdk_drag_abort (GdkDragContext *context,
* Drops on the current destination.
*
* This function is called by the drag source.
+ *
+ * This function does not need to be called in managed drag and drop
+ * operations. See gdk_drag_context_manage_dnd() for more information.
*/
void
gdk_drag_drop (GdkDragContext *context,