Method

GtkWidgetpick

Declaration [src]

GtkWidget*
gtk_widget_pick (
  GtkWidget* widget,
  double x,
  double y,
  GtkPickFlags flags
)

Description [src]

Finds the descendant of the widget closest to a point.

The point (x, y) must be given in widget coordinates, so (0, 0) is assumed to be the top left of widget‘s content area.

Usually widgets will return NULL if the given coordinate is not contained in widget checked via gtk_widget_contains(). Otherwise they will recursively try to find a child that does not return NULL. Widgets are however free to customize their picking algorithm.

This function is used on the toplevel to determine the widget below the mouse cursor for purposes of hover highlighting and delivering events.

Parameters

x

Type: double

X coordinate to test, relative to widget‘s origin.

y

Type: double

Y coordinate to test, relative to widget‘s origin.

flags

Type: GtkPickFlags

Flags to influence what is picked.

Return value

Type: GtkWidget

The widget’s descendant at (x, y).

The returned data is owned by the instance.

The return value can be NULL.