Method

GtkWidgetdrag_get_data

Declaration [src]

void
gtk_drag_get_data (
  GtkWidget* widget,
  GdkDragContext* context,
  GdkAtom target,
  guint32 time_
)

Description [src]

Gets the data associated with a drag. When the data is received or the retrieval fails, GTK+ will emit a GtkWidget::drag-data-received signal. Failure of the retrieval is indicated by the length field of the selection_data signal parameter being negative. However, when gtk_drag_get_data() is called implicitely because the GTK_DEST_DEFAULT_DROP was set, then the widget will not receive notification of failed drops.

Parameters

context GdkDragContext
 

The drag context.

 The data is owned by the caller of the function.
target GdkAtom
 

The target (form of the data) to retrieve.

time_ guint32
 

A timestamp for retrieving the data. This will generally be the time received in a GtkWidget::drag-motion or GtkWidget::drag-drop signal.