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

Type: GdkDragContext

The drag context.

The data is owned by the caller of the method.

target

Type: GdkAtom

The target (form of the data) to retrieve.

time_

Type: guint32

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