summaryrefslogtreecommitdiff
path: root/gtk/gtkdnd.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2017-12-30 22:46:28 -0500
committerMatthias Clasen <mclasen@redhat.com>2017-12-30 22:46:28 -0500
commit1be0b6d2d51af957396b5a517ca5e0ee010a3a21 (patch)
tree5d7161821fab5b75bc4c57f44787c1cf9cca5032 /gtk/gtkdnd.c
parent74f563b50136c72e021f68a3f0256ed5cad69d01 (diff)
downloadgtk+-1be0b6d2d51af957396b5a517ca5e0ee010a3a21.tar.gz
dnd: Drop docs that are no longer relevant
We no longer take an event as argument, so no need to explain how to obtain a suitable event.
Diffstat (limited to 'gtk/gtkdnd.c')
-rw-r--r--gtk/gtkdnd.c22
1 files changed, 0 insertions, 22 deletions
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index f12a507f03..f072239b6d 100644
--- a/gtk/gtkdnd.c
+++ b/gtk/gtkdnd.c
@@ -1032,28 +1032,6 @@ gtk_drag_begin_internal (GtkWidget *widget,
* when the application is starting drags itself, and is not needed when
* gtk_drag_source_set() is used.
*
- * The @event is used to retrieve the timestamp that will be used internally to
- * grab the pointer. If @event is %NULL, then %GDK_CURRENT_TIME will be used.
- * However, you should try to pass a real event in all cases, since that can be
- * used to get information about the drag.
- *
- * Generally there are three cases when you want to start a drag by hand by
- * calling this function:
- *
- * 1. During a #GtkWidget::button-press-event handler, if you want to start a drag
- * immediately when the user presses the mouse button. Pass the @event
- * that you have in your #GtkWidget::button-press-event handler.
- *
- * 2. During a #GtkWidget::motion-notify-event handler, if you want to start a drag
- * when the mouse moves past a certain threshold distance after a button-press.
- * Pass the @event that you have in your #GtkWidget::motion-notify-event handler.
- *
- * 3. During a timeout handler, if you want to start a drag after the mouse
- * button is held down for some time. Try to save the last event that you got
- * from the mouse, using g_object_ref(), and pass it to this function
- * (remember to free the event with g_object_unref() when you are done).
- * If you can really not pass a real event, pass %NULL instead.
- *
* Returns: (transfer none): the context for this drag
*
* Since: 3.10