Function

Gtktest_find_label

since: 2.14

Declaration [src]

GtkWidget*
gtk_test_find_label (
  GtkWidget* widget,
  const gchar* label_pattern
)

Description [src]

This function will search widget and all its descendants for a GtkLabel widget with a text string matching label_pattern. The label_pattern may contain asterisks “*” and question marks “?” as placeholders, g_pattern_match() is used for the matching. Note that locales other than “C“ tend to alter (translate” label strings, so this function is genrally only useful in test programs with predetermined locales, see gtk_test_init() for more details.

Available since: 2.14

Parameters

widget

Type: GtkWidget

Valid label or container widget.

The data is owned by the caller of the function.

label_pattern

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.

Return value

Type: GtkWidget

A GtkLabel widget if any is found.

The data is owned by the called function.