Function

Gdkdrag_find_window_for_screen

since: 2.2

Declaration [src]

void
gdk_drag_find_window_for_screen (
  GdkDragContext* context,
  GdkWindow* drag_window,
  GdkScreen* screen,
  gint x_root,
  gint y_root,
  GdkWindow** dest_window,
  GdkDragProtocol* protocol
)

Description [src]

Finds the destination window and DND protocol to use at the given pointer position.

This function is called by the drag source to obtain the dest_window and protocol parameters for gdk_drag_motion().

Available since: 2.2

Parameters

context

Type: GdkDragContext

A GdkDragContext.

The data is owned by the caller of the function.

drag_window

Type: GdkWindow

A window which may be at the pointer position, but should be ignored, since it is put up by the drag source as an icon.

The data is owned by the caller of the function.

screen

Type: GdkScreen

The screen where the destination window is sought.

The data is owned by the caller of the function.

x_root

Type: gint

The x position of the pointer in root coordinates.

y_root

Type: gint

The y position of the pointer in root coordinates.

dest_window

Type: GdkWindow

Location to store the destination window in.

The argument will be set by the function.

The caller of the function takes ownership of the returned data, and is responsible for freeing it.

protocol

Type: GdkDragProtocol

Location to store the DND protocol in.

The argument will be set by the function.

The caller of the function takes ownership of the returned data, and is responsible for freeing it.