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 test_find_label, test_find_sibling and test_widget_click for possible caveats involving the search of such widgets and synthesizing widget events.
| widget |
Container widget, usually a GtkWindow. |
| label_pattern |
Shell-glob pattern to match a label string. |
| widget_type |
Type of a aearched for label sibling widget. |
|
a valid widget if any is found or null. |