Method

GtkWidgetdrag_dest_find_target

Declaration [src]

GdkAtom
gtk_drag_dest_find_target (
  GtkWidget* widget,
  GdkDragContext* context,
  GtkTargetList* target_list
)

Description [src]

Looks for a match between the supported targets of context and the dest_target_list, returning the first matching target, otherwise returning GDK_NONE. dest_target_list should usually be the return value from gtk_drag_dest_get_target_list(), but some widgets may have different valid targets for different parts of the widget; in that case, they will have to implement a drag_motion handler that passes the correct target list to this function.

Parameters

context

Type: GdkDragContext

Drag context.

The data is owned by the caller of the method.

target_list

Type: GtkTargetList

List of droppable targets, or NULL to use gtk_drag_dest_get_target_list (widget).

The argument can be NULL.

The data is owned by the caller of the method.

Return value

Type: GdkAtom

First target that the source offers and the dest can accept, or GDK_NONE.