[gtk/x11-dnd-fixes: 3/3] Add detail to gdk_drag_begin docs



commit ec383a238842b5e50a4e8008c6e59ab5b7158dc7
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Feb 22 18:50:28 2020 -0500

    Add detail to gdk_drag_begin docs
    
    Mention that GTK keeps a reference while the drag
    operation is ongoing.

 gdk/gdksurface.c | 4 ++++
 1 file changed, 4 insertions(+)
---
diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c
index 399e40c368..13b0dec48d 100644
--- a/gdk/gdksurface.c
+++ b/gdk/gdksurface.c
@@ -3587,6 +3587,10 @@ gdk_surface_register_dnd (GdkSurface *surface)
  * probably want to set up the drag icon using the surface returned
  * 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
  * the #GdkDrag::dnd-finished signal and delete the data at the source
  * if gdk_drag_get_selected_action() returns %GDK_ACTION_MOVE.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]