diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2017-12-30 22:46:28 -0500 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2017-12-30 22:46:28 -0500 |
| commit | 1be0b6d2d51af957396b5a517ca5e0ee010a3a21 (patch) | |
| tree | 5d7161821fab5b75bc4c57f44787c1cf9cca5032 /gtk/gtkdnd.c | |
| parent | 74f563b50136c72e021f68a3f0256ed5cad69d01 (diff) | |
| download | gtk+-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.c | 22 |
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 |