Package: gtk

Function gtk-ui-manager-widget

Lambda List

gtk-ui-manager-widget (manager path)

Arguments

manager -- a gtk-ui-manager object
path -- a string with a path

Return Value

The gtk-widget object found by following the path, or nil if no widget was found.

Details

Looks up a widget by following a path. The path consists of the names specified in the XML description of the UI separated by '/'. Elements which do not have a name or action attribute in the XML, e.g. <popup>, can be addressed by their XML element name, e.g. "popup". The root element ("/ui") can be omitted in the path.

Note that the widget found by following a path that ends in a <menu> element is the menuitem to which the menu is attached, not the menu itself.

Also note that the widgets constructed by a UI manager are not tied to the life cycle of the UI manager. If you add the widgets returned by this function to some container or explicitly reference them, they will survive the destruction of the UI manager.

Warning

The function gtk-ui-manager-widget has been deprecated since version 3.10 and should not be used in newly written code.
 

See also

*2021-7-24