Function

Gtktest_find_label

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 GtkWidget
 

Valid label or container widget.

 The data is owned by the caller of the function.
label_pattern const gchar*
 

Shell-glob pattern to match a label string.

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

Return value

Returns: GtkWidget
 

A GtkLabel widget if any is found.

 The data is owned by the called function.