Declaration [src]

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.


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.