Declaration [src]

gtk_test_find_sibling (
  GtkWidget* base_widget,
  GType widget_type

Description [src]

This function will search siblings of base_widget and siblings of its ancestors for all widgets matching widget_type. Of the matching widgets, the one that is geometrically closest to base_widget will be returned. The general purpose of this function is to find the most likely “action” widget, relative to another labeling widget. Such as finding a button or text entry widget, given its corresponding label widget.

Available since:2.14


base_widget GtkWidget

Valid widget, part of a widget hierarchy.

 The data is owned by the caller of the function.
widget_type GType

Type of a aearched for sibling widget.

Return value

Returns: GtkWidget

A widget of type widget_type if any is found.

 The data is owned by the called function.