BonoboUIEngine
The guts of the UI handler
The Bonobo UI code as exposed through the #BonoboWindow,
#BonoboUIComponent and #BonoboUIContainer API's use the
BonoboUIEngine. The Engine effectively maintains a
#BonoboUIXml tree internaly, and a list of #BonoboUISync
synchronizers that, when the tree changes are used to
re-sync the associated widgets with the XML model.
The Engine can be tweaked by getting its pointer from an
associated BonoboWindow eg. this can be useful for setting
the configuration path. To allow a BonoboWindow to be
configurable you need to do:
How to make your UI user configurable
bonobo_ui_engine_config_set_path (
bonobo_window_get_ui_engine (win),
"/my-application-name/UIConfig/kvps");
where "UIConfig/kvps" is some convenient path into your
gnome_config file.
Key value pairs (kvps) are stored in
this, mangled into a comma delimited string and these are
used to clobber the XML on merges, eg.
User configuration format
[UIConfig]
kvps=/Toolbar:look:both
inside your ~/.gnome/my-application-name file, will
ensure that whenever the item with path '/Toolbar' is
modified the 'look="both"' attribute will be stamped
onto it, effecively forcing a certain look.
@bonobouiengine: the object which received the signal.
@arg1:
@bonobouiengine: the object which received the signal.
@bonobouiengine: the object which received the signal.
@arg1:
@arg2:
@bonobouiengine: the object which received the signal.
@arg1:
@bonobouiengine: the object which received the signal.
@engine:
@engine:
@ref:
@engine:
@name:
@engine:
@name:
@component:
@engine:
@Returns:
@engine:
@name:
@Returns:
@engine:
@path:
@engine:
@Returns:
@engine:
@ui_container:
@engine:
@Returns:
@engine:
@engine:
@engine:
@BONOBO_UI_ERROR_OK:
@BONOBO_UI_ERROR_BAD_PARAM:
@BONOBO_UI_ERROR_INVALID_PATH:
@BONOBO_UI_ERROR_INVALID_XML:
@parent_class:
@add_hint:
@remove_hint:
@emit_verb_on:
@emit_event_on:
@destroy:
@engine:
@view:
@Returns:
@view:
@Returns:
@engine:
@Returns:
@engine:
@sync:
@engine:
@sync:
@engine:
@Returns:
@engine:
@sync:
@node:
@engine:
@widget:
@node:
@cmd_node:
@engine:
@node:
@Returns:
@widget:
@Returns:
@engine:
@widget:
@node:
@engine:
@path:
@property:
@value:
@component:
@Returns:
@engine:
@path:
@prop:
@invalid_path:
@Returns:
@engine:
@node:
@save_custom:
@engine:
@path:
@Returns:
@engine:
@node:
@engine:
@node:
@engine:
@out:
@msg:
@engine:
@node:
@Returns:
@engine:
@node:
@Returns:
@engine:
@node:
@Returns:
@engine:
@node:
@Returns:
@engine:
@from_node:
@Returns:
@engine:
@node:
@dirty:
@engine:
@node:
@engine:
@path:
@widget:
@engine:
@node:
@widget:
@engine:
@str:
@engine:
@engine:
@node:
@engine:
@node:
@state:
@engine:
@widget:
@engine:
@widget:
@state:
@node:
@cmd_node:
@attr:
@Returns:
@widget:
@node:
@engine:
@path:
@node_only:
@Returns:
@engine:
@path:
@Returns:
@engine:
@path:
@tree:
@component:
@Returns:
@engine:
@path:
@by_component:
@Returns:
@engine:
@path:
@object:
@ev:
@Returns:
@engine:
@path:
@object:
@ev:
@Returns:
@engine:
@cname:
@ev:
@engine:
@id:
@type:
@state:
@ev: