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.
This commit is contained in:
Carlos Garnacho 2016-01-18 22:22:24 +01:00
parent 5b1d96234d
commit 40b28ac66a

View File

@ -428,6 +428,9 @@ gdk_drag_status (GdkDragContext *context,
* *
* This function is called by the drag source. * 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: * Returns:
*/ */
gboolean gboolean
@ -461,6 +464,9 @@ gdk_drag_motion (GdkDragContext *context,
* Aborts a drag without dropping. * Aborts a drag without dropping.
* *
* This function is called by the drag source. * 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 void
gdk_drag_abort (GdkDragContext *context, gdk_drag_abort (GdkDragContext *context,
@ -479,6 +485,9 @@ gdk_drag_abort (GdkDragContext *context,
* Drops on the current destination. * Drops on the current destination.
* *
* This function is called by the drag source. * 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 void
gdk_drag_drop (GdkDragContext *context, gdk_drag_drop (GdkDragContext *context,