Function

Gtktest_find_sibling

since: 2.14

Declaration [src]

GtkWidget*
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

Parameters

base_widget

Type: GtkWidget

Valid widget, part of a widget hierarchy.

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

Type: GType

Type of a aearched for sibling widget.

Return value

Type: GtkWidget

A widget of type widget_type if any is found.

The data is owned by the called function.