since: 2.14

Declaration [src]

gtk_test_find_widget (
  GtkWidget* widget,
  const gchar* label_pattern,
  GType widget_type

Description [src]

This function will search the descendants of widget for a widget of type widget_type that has a label matching label_pattern next to it. This is most useful for automated GUI testing, e.g. to find the “OK” button in a dialog and synthesize clicks on it. However see gtk_test_find_label(), gtk_test_find_sibling() and gtk_test_widget_click() for possible caveats involving the search of such widgets and synthesizing widget events.

Available since: 2.14



Type: GtkWidget

Container widget, usually a GtkWindow.

The data is owned by the caller of the function.

Type: const gchar*

Shell-glob pattern to match a label string.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Type: GType

Type of a aearched for label sibling widget.

Return value

Type: GtkWidget

A valid widget if any is found or NULL.

The data is owned by the called function.
The return value can be NULL.