Signal

Gtk.DropTargetAsync::drop

Declaration

gboolean
drop (
  GtkDropTargetAsync self,
  GdkDrop* drop,
  gdouble x,
  gdouble y,
  gpointer user_data
)

Description [src]

Emitted on the drop site when the user drops the data onto the widget.

The signal handler must determine whether the pointer position is in a drop zone or not. If it is not in a drop zone, it returns FALSE and no further processing is necessary.

Otherwise, the handler returns TRUE. In this case, this handler will accept the drop. The handler must ensure that gdk_drop_finish() is called to let the source know that the drop is done. The call to gdk_drop_finish() must only be done when all data has been received.

To receive the data, use one of the read functions provided by GdkDrop such as gdk_drop_read_async() or gdk_drop_read_value_async().

Default handler:

The default handler is called after the handlers added via g_signal_connect()

Parameters

drop GdkDrop*
 

the GdkDrop

 Ownership is not transferred to the callee
x gdouble
 

the x coordinate of the current pointer position

y gdouble
 

the y coordinate of the current pointer position

Return value

Returns: gboolean

whether the drop is accepted at the given pointer position