Function

Gtkdrag_cancel

since: 3.16

Declaration [src]

void
gtk_drag_cancel (
  GdkDragContext* context
)

Description [src]

Cancels an ongoing drag operation on the source side.

If you want to be able to cancel a drag operation in this way, you need to keep a pointer to the drag context, either from an explicit call to gtk_drag_begin_with_coordinates(), or by connecting to GtkWidget::drag-begin.

If context does not refer to an ongoing drag operation, this function does nothing.

If a drag is cancelled in this way, the result argument of GtkWidget::drag-failed is set to GTK_DRAG_RESULT_ERROR.

Available since: 3.16

Parameters

context

Type: GdkDragContext

A GdkDragContext, as e.g. returned by gtk_drag_begin_with_coordinates().

The data is owned by the caller of the function.