[gtk+] dnd: Drop docs that are no longer relevant
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] dnd: Drop docs that are no longer relevant
- Date: Sun, 31 Dec 2017 04:25:59 +0000 (UTC)
commit 1be0b6d2d51af957396b5a517ca5e0ee010a3a21
Author: Matthias Clasen <mclasen redhat com>
Date: Sat Dec 30 22:46:28 2017 -0500
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.
gtk/gtkdnd.c | 22 ----------------------
1 files changed, 0 insertions(+), 22 deletions(-)
---
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index f12a507..f072239 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
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]