testFindWidget

fngtk.widget.Widget testFindWidget(gtk.widget.Widget widget, string labelPattern, gobject.types.GType widgetType)

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`	Container widget, usually a GtkWindow.
`labelPattern`	Shell-glob pattern to match a label string.
`widgetType`	Type of a aearched for label sibling widget.

Returns

a valid widget if any is found or null.