Add detail to gdk_drag_begin docs

Mention that GTK keeps a reference while the drag
operation is ongoing.
This commit is contained in:
Matthias Clasen 2020-02-22 18:50:28 -05:00
parent 7c1cfc5533
commit ec383a2388

View File

@ -3587,6 +3587,10 @@ gdk_surface_register_dnd (GdkSurface *surface)
* probably want to set up the drag icon using the surface returned * probably want to set up the drag icon using the surface returned
* by gdk_drag_get_drag_surface(). * by gdk_drag_get_drag_surface().
* *
* This function returns a reference to the GdkDrag object, but GTK
* keeps its own reference as well, as long as the DND operation is
* going on.
*
* Note: if @actions include %GDK_ACTION_MOVE, you need to listen for * Note: if @actions include %GDK_ACTION_MOVE, you need to listen for
* the #GdkDrag::dnd-finished signal and delete the data at the source * the #GdkDrag::dnd-finished signal and delete the data at the source
* if gdk_drag_get_selected_action() returns %GDK_ACTION_MOVE. * if gdk_drag_get_selected_action() returns %GDK_ACTION_MOVE.