testFindWidget

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.global.testFindLabel, gtk.global.testFindSibling and gtk.global.testWidgetClick for possible caveats involving the search of such widgets and synthesizing widget events.

Parameters

widget gtk.widget.Widget

Container widget, usually a GtkWindow.

labelPattern string

Shell-glob pattern to match a label string.

widgetType gobject.types.GType

Type of a aearched for label sibling widget.

Return Value

Type: gtk.widget.Widget

a valid widget if any is found or null.