File: //usr/local/ssl/share/gtk-doc/html/libbonoboui/libbonoboui-bonobo-ui-engine.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>BonoboUIEngine</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="LibBonoboUI API Reference Manual">
<link rel="up" href="bonobo-ui.html" title="Bonobo UI">
<link rel="prev" href="libbonoboui-bonobo-ui-node.html" title="bonobo-ui-node">
<link rel="next" href="libbonoboui-bonobo-ui-engine-config.html" title="bonobo-ui-engine-config">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="bonobo-controls.html" title="Controls">
<link rel="chapter" href="bonobo-ui.html" title="Bonobo UI">
<link rel="chapter" href="bonobo-support-utilities.html" title="Supporting Classes">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libbonoboui-bonobo-ui-node.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="bonobo-ui.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">LibBonoboUI API Reference Manual</th>
<td><a accesskey="n" href="libbonoboui-bonobo-ui-engine-config.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2797819" class="shortcut">Top</a>
 | 
<a href="#id2800023" class="shortcut">Description</a>
 | 
<a href="#id2799786" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id2799811" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libbonoboui-bonobo-ui-engine"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2797819"></a><span class="refentrytitle">BonoboUIEngine</span>
</h2>
<p>BonoboUIEngine — The guts of the UI handler</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<a name="BonoboUIEngine"></a><pre class="synopsis">
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-struct">BonoboUIEngine</a>;
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-deregister-dead-components">bonobo_ui_engine_deregister_dead_components</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-deregister-component-by-ref">bonobo_ui_engine_deregister_component_by_ref</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
Bonobo_Unknown ref);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-deregister-component">bonobo_ui_engine_deregister_component</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-register-component">bonobo_ui_engine_register_component</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name,
Bonobo_Unknown component);
<a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-component-names">bonobo_ui_engine_get_component_names</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
Bonobo_Unknown <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-component">bonobo_ui_engine_get_component</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-config-set-path">bonobo_ui_engine_config_set_path</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);
const char* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-config-get-path">bonobo_ui_engine_config_get_path</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-set-ui-container">bonobo_ui_engine_set_ui_container</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer">BonoboUIContainer</a> *ui_container);
<a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer">BonoboUIContainer</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-ui-container">bonobo_ui_engine_get_ui_container</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-freeze">bonobo_ui_engine_freeze</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-thaw">bonobo_ui_engine_thaw</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-update">bonobo_ui_engine_update</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
enum <a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a>;
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEnginePrivate">BonoboUIEnginePrivate</a>;
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngineClass">BonoboUIEngineClass</a>;
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-construct">bonobo_ui_engine_construct</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *view);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-new">bonobo_ui_engine_new</a> (<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *view);
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-view">bonobo_ui_engine_get_view</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-add-sync">bonobo_ui_engine_add_sync</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-remove-sync">bonobo_ui_engine_remove_sync</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync);
<a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-syncs">bonobo_ui_engine_get_syncs</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-update-node">bonobo_ui_engine_update_node</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-queue-update">bonobo_ui_engine_queue_update</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *cmd_node);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-build-control">bonobo_ui_engine_build_control</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-widget-get-node">bonobo_ui_engine_widget_get_node</a>
(<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-widget-set-node">bonobo_ui_engine_widget_set_node</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-set-prop">bonobo_ui_engine_xml_set_prop</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *property,
const char *value,
const char *component);
CORBA_char* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-get-prop">bonobo_ui_engine_xml_get_prop</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *prop,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> *invalid_path);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-prune-widget-info">bonobo_ui_engine_prune_widget_info</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> save_custom);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-path">bonobo_ui_engine_get_path</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-dirty-tree">bonobo_ui_engine_dirty_tree</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-clean-tree">bonobo_ui_engine_clean_tree</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-dump">bonobo_ui_engine_dump</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
FILE *out,
const char *msg);
CORBA_Object <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-node-get-object">bonobo_ui_engine_node_get_object</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-node-is-dirty">bonobo_ui_engine_node_is_dirty</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-node-get-widget">bonobo_ui_engine_node_get_widget</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
const char* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-node-get-id">bonobo_ui_engine_node_get_id</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-cmd-node">bonobo_ui_engine_get_cmd_node</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *from_node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-node-set-dirty">bonobo_ui_engine_node_set_dirty</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> dirty);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-stamp-custom">bonobo_ui_engine_stamp_custom</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-widget-set">bonobo_ui_engine_widget_set</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-stamp-root">bonobo_ui_engine_stamp_root</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-add-hint">bonobo_ui_engine_add_hint</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *str);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-remove-hint">bonobo_ui_engine_remove_hint</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-emit-verb-on">bonobo_ui_engine_emit_verb_on</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-emit-event-on">bonobo_ui_engine_emit_event_on</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *state);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-emit-verb-on-w">bonobo_ui_engine_emit_verb_on_w</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-emit-event-on-w">bonobo_ui_engine_emit_event_on_w</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
const char *state);
char* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-get-attr">bonobo_ui_engine_get_attr</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *cmd_node,
const char *attr);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-widget-attach-node">bonobo_ui_engine_widget_attach_node</a>
(<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
CORBA_char* <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-get">bonobo_ui_engine_xml_get</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> node_only);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-node-exists">bonobo_ui_engine_xml_node_exists</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-merge-tree">bonobo_ui_engine_xml_merge_tree</a>
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *tree,
const char *component);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-xml-rm">bonobo_ui_engine_xml_rm</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *by_component);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-object-set">bonobo_ui_engine_object_set</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
Bonobo_Unknown object,
CORBA_Environment *ev);
<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-object-get">bonobo_ui_engine_object_get</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
Bonobo_Unknown *object,
CORBA_Environment *ev);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-exec-verb">bonobo_ui_engine_exec_verb</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const CORBA_char *cname,
CORBA_Environment *ev);
void <a href="libbonoboui-bonobo-ui-engine.html#bonobo-ui-engine-ui-event">bonobo_ui_engine_ui_event</a> (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const CORBA_char *id,
const Bonobo_UIComponent_EventType type,
const CORBA_char *state,
CORBA_Environment *ev);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2799786"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----BonoboUIEngine
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2799811"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-add-hint">add-hint</a>" void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-destroy">destroy</a>" void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-emit-event-on">emit-event-on</a>"
void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg2,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-emit-verb-on">emit-verb-on</a>"
void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine-remove-hint">remove-hint</a>"
void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2800023"></a><h2>Description</h2>
<p>
The Bonobo UI code as exposed through the <a href="libbonoboui-bonobo-window.html#BonoboWindow"><span class="type">BonoboWindow</span></a>,
<a href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="type">BonoboUIComponent</span></a> and <a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> API's use the
BonoboUIEngine. The Engine effectively maintains a
<span class="type">BonoboUIXml</span> tree internaly, and a list of <a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync"><span class="type">BonoboUISync</span></a>
synchronizers that, when the tree changes are used to
re-sync the associated widgets with the XML model.
</p>
<p>
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:
</p>
<div class="example">
<a name="id2800087"></a><p class="title"><b>Example 4. How to make your UI user configurable</b></p>
<pre class="programlisting">
bonobo_ui_engine_config_set_path (
bonobo_window_get_ui_engine (win),
"/my-application-name/UIConfig/kvps");
</pre>
</div>
<p>
where "UIConfig/kvps" is some convenient path into your
gnome_config file.
</p>
<p>
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.
</p>
<div class="example">
<a name="id2800109"></a><p class="title"><b>Example 5. User configuration format</b></p>
<pre class="programlisting">
[UIConfig]
kvps=/Toolbar:look:both
</pre>
</div>
<p>
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.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2800128"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2800139"></a><h3>
<a name="BonoboUIEngine-struct"></a>BonoboUIEngine</h3>
<a class="indexterm" name="id2800152"></a><pre class="programlisting">typedef struct _BonoboUIEngine BonoboUIEngine;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800168"></a><h3>
<a name="bonobo-ui-engine-deregister-dead-components"></a>bonobo_ui_engine_deregister_dead_components ()</h3>
<a class="indexterm" name="id2800182"></a><pre class="programlisting">void bonobo_ui_engine_deregister_dead_components
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
Detect any components that have died and deregister
them - unmerging their UI elements.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800234"></a><h3>
<a name="bonobo-ui-engine-deregister-component-by-ref"></a>bonobo_ui_engine_deregister_component_by_ref ()</h3>
<a class="indexterm" name="id2800248"></a><pre class="programlisting">void bonobo_ui_engine_deregister_component_by_ref
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
Bonobo_Unknown ref);</pre>
<p>
Deregisters component with reference <em class="parameter"><code>ref</code></em> from <em class="parameter"><code>engine</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ref</code></em> :</span></td>
<td> the ref.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800333"></a><h3>
<a name="bonobo-ui-engine-deregister-component"></a>bonobo_ui_engine_deregister_component ()</h3>
<a class="indexterm" name="id2800347"></a><pre class="programlisting">void bonobo_ui_engine_deregister_component
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name);</pre>
<p>
Deregisters component of <em class="parameter"><code>name</code></em> from <em class="parameter"><code>engine</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the component name
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800433"></a><h3>
<a name="bonobo-ui-engine-register-component"></a>bonobo_ui_engine_register_component ()</h3>
<a class="indexterm" name="id2800447"></a><pre class="programlisting">void bonobo_ui_engine_register_component
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name,
Bonobo_Unknown component);</pre>
<p>
Registers <em class="parameter"><code>component</code></em> with <em class="parameter"><code>engine</code></em> by <em class="parameter"><code>name</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> a name to associate a component with
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>component</code></em> :</span></td>
<td> the component
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800560"></a><h3>
<a name="bonobo-ui-engine-get-component-names"></a>bonobo_ui_engine_get_component_names ()</h3>
<a class="indexterm" name="id2800574"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>* bonobo_ui_engine_get_component_names
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the names of all registered components
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800636"></a><h3>
<a name="bonobo-ui-engine-get-component"></a>bonobo_ui_engine_get_component ()</h3>
<a class="indexterm" name="id2800650"></a><pre class="programlisting">Bonobo_Unknown bonobo_ui_engine_get_component
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *name);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the component to fetch
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the component with name <em class="parameter"><code>name</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800739"></a><h3>
<a name="bonobo-ui-engine-config-set-path"></a>bonobo_ui_engine_config_set_path ()</h3>
<a class="indexterm" name="id2800753"></a><pre class="programlisting">void bonobo_ui_engine_config_set_path
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800822"></a><h3>
<a name="bonobo-ui-engine-config-get-path"></a>bonobo_ui_engine_config_get_path ()</h3>
<a class="indexterm" name="id2800835"></a><pre class="programlisting">const char* bonobo_ui_engine_config_get_path
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800894"></a><h3>
<a name="bonobo-ui-engine-set-ui-container"></a>bonobo_ui_engine_set_ui_container ()</h3>
<a class="indexterm" name="id2800908"></a><pre class="programlisting">void bonobo_ui_engine_set_ui_container
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer">BonoboUIContainer</a> *ui_container);</pre>
<p>
Associates a given UI Container with this BonoboUIEngine.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ui_container</code></em> :</span></td>
<td> a UI Container bonobo object.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2800982"></a><h3>
<a name="bonobo-ui-engine-get-ui-container"></a>bonobo_ui_engine_get_ui_container ()</h3>
<a class="indexterm" name="id2800996"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer">BonoboUIContainer</a>* bonobo_ui_engine_get_ui_container
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
Fetches the associated UI Container</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the associated UI container.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801058"></a><h3>
<a name="bonobo-ui-engine-freeze"></a>bonobo_ui_engine_freeze ()</h3>
<a class="indexterm" name="id2801074"></a><pre class="programlisting">void bonobo_ui_engine_freeze (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">bonobo_ui_engine_freeze</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This increments the freeze count on the tree, while
this count > 0 no syncronization between the internal
XML model and the widget views occurs. This means that
many simple merges can be glupped together with little
performance impact and overhead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801147"></a><h3>
<a name="bonobo-ui-engine-thaw"></a>bonobo_ui_engine_thaw ()</h3>
<a class="indexterm" name="id2801163"></a><pre class="programlisting">void bonobo_ui_engine_thaw (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">bonobo_ui_engine_thaw</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This decrements the freeze count and if it is 0
causes the UI widgets to be re-synched with the
XML model, see also bonobo_ui_engine_freeze</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801228"></a><h3>
<a name="bonobo-ui-engine-update"></a>bonobo_ui_engine_update ()</h3>
<a class="indexterm" name="id2801243"></a><pre class="programlisting">void bonobo_ui_engine_update (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">bonobo_ui_engine_update</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is called to update the entire
UI model synchronizing any changes in it with
the widget tree where neccessary</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801308"></a><h3>
<a name="BonoboUIError"></a>enum BonoboUIError</h3>
<a class="indexterm" name="id2801321"></a><pre class="programlisting">typedef enum {
BONOBO_UI_ERROR_OK = 0,
BONOBO_UI_ERROR_BAD_PARAM,
BONOBO_UI_ERROR_INVALID_PATH,
BONOBO_UI_ERROR_INVALID_XML
} BonoboUIError;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801338"></a><h3>
<a name="BonoboUIEnginePrivate"></a>BonoboUIEnginePrivate</h3>
<a class="indexterm" name="id2801351"></a><pre class="programlisting">typedef struct _BonoboUIEnginePrivate BonoboUIEnginePrivate;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801367"></a><h3>
<a name="BonoboUIEngineClass"></a>BonoboUIEngineClass</h3>
<a class="indexterm" name="id2801380"></a><pre class="programlisting">typedef struct {
GObjectClass parent_class;
/* Signals */
void (*add_hint) (BonoboUIEngine *engine,
const char *str);
void (*remove_hint) (BonoboUIEngine *engine);
void (*emit_verb_on) (BonoboUIEngine *engine,
BonoboUINode *node);
void (*emit_event_on) (BonoboUIEngine *engine,
BonoboUINode *node,
const char *state);
void (*destroy) (BonoboUIEngine *engine);
} BonoboUIEngineClass;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801403"></a><h3>
<a name="bonobo-ui-engine-construct"></a>bonobo_ui_engine_construct ()</h3>
<a class="indexterm" name="id2801416"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a>* bonobo_ui_engine_construct (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *view);</pre>
<p>
Construct a new bonobo_ui_engine</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>view</code></em> :</span></td>
<td> the view [ often a BonoboWindow ]
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the constructed engine.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801499"></a><h3>
<a name="bonobo-ui-engine-new"></a>bonobo_ui_engine_new ()</h3>
<a class="indexterm" name="id2801512"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a>* bonobo_ui_engine_new (<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *view);</pre>
<p>
Create a new <a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine"><span class="type">BonoboUIEngine</span></a> structure</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>view</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new UI Engine.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801581"></a><h3>
<a name="bonobo-ui-engine-get-view"></a>bonobo_ui_engine_get_view ()</h3>
<a class="indexterm" name="id2801594"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>* bonobo_ui_engine_get_view (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
This returns the associated view, often a BonoboWindow</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the view widget.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801655"></a><h3>
<a name="bonobo-ui-engine-add-sync"></a>bonobo_ui_engine_add_sync ()</h3>
<a class="indexterm" name="id2801669"></a><pre class="programlisting">void bonobo_ui_engine_add_sync (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync);</pre>
<p>
Add a <a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync"><span class="type">BonoboUISync</span></a> synchronizer to the engine</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the enginer
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sync</code></em> :</span></td>
<td> the synchronizer
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801749"></a><h3>
<a name="bonobo-ui-engine-remove-sync"></a>bonobo_ui_engine_remove_sync ()</h3>
<a class="indexterm" name="id2801763"></a><pre class="programlisting">void bonobo_ui_engine_remove_sync (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync);</pre>
<p>
Remove a specified <a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync"><span class="type">BonoboUISync</span></a> synchronizer from the engine</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sync</code></em> :</span></td>
<td> the sync
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801844"></a><h3>
<a name="bonobo-ui-engine-get-syncs"></a>bonobo_ui_engine_get_syncs ()</h3>
<a class="indexterm" name="id2801858"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a>* bonobo_ui_engine_get_syncs (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
Retrieve a list of available synchronizers.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a GSList of <a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync"><span class="type">BonoboUISync</span></a> s
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2801927"></a><h3>
<a name="bonobo-ui-engine-update-node"></a>bonobo_ui_engine_update_node ()</h3>
<a class="indexterm" name="id2801941"></a><pre class="programlisting">void bonobo_ui_engine_update_node (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-sync.html#BonoboUISync">BonoboUISync</a> *sync,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
This function is used to write recursive synchronizers
and is intended only for internal / privilaged use.
</p>
<p>
By the time this returns, due to re-enterancy, node
points at undefined memory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sync</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node to start updating.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802041"></a><h3>
<a name="bonobo-ui-engine-queue-update"></a>bonobo_ui_engine_queue_update ()</h3>
<a class="indexterm" name="id2802055"></a><pre class="programlisting">void bonobo_ui_engine_queue_update (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *cmd_node);</pre>
<p>
This function is used to queue a state update on
<em class="parameter"><code>widget</code></em>, essentialy transfering any state from the
XML model into the widget view. This is queued to
avoid re-enterancy problems.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget to update later
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cmd_node</code></em> :</span></td>
<td> the associated command's node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802180"></a><h3>
<a name="bonobo-ui-engine-build-control"></a>bonobo_ui_engine_build_control ()</h3>
<a class="indexterm" name="id2802193"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* bonobo_ui_engine_build_control (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
A helper function for synchronizers, this creates a control
if possible from the node's associated object, stamps the
node as containing a control and sets its widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the control node.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a Control's GtkWidget.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802279"></a><h3>
<a name="bonobo-ui-engine-widget-get-node"></a>bonobo_ui_engine_widget_get_node ()</h3>
<a class="indexterm" name="id2802293"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_engine_widget_get_node
(<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the <a href="libbonoboui-bonobo-ui-node.html#BonoboUINode"><span class="type">BonoboUINode</span></a> associated with this widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802363"></a><h3>
<a name="bonobo-ui-engine-widget-set-node"></a>bonobo_ui_engine_widget_set_node ()</h3>
<a class="indexterm" name="id2802376"></a><pre class="programlisting">void bonobo_ui_engine_widget_set_node
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Used internaly to associate a widget with a node,
some synchronisers need to be able to execute code
on widget creation.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802473"></a><h3>
<a name="bonobo-ui-engine-xml-set-prop"></a>bonobo_ui_engine_xml_set_prop ()</h3>
<a class="indexterm" name="id2802487"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> bonobo_ui_engine_xml_set_prop (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *property,
const char *value,
const char *component);</pre>
<p>
This function sets the property of a node in the internal tree
representation at <em class="parameter"><code>path</code></em> in <em class="parameter"><code>engine</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>property</code></em> :</span></td>
<td> The property to set
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td> The new value of the property
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>component</code></em> :</span></td>
<td> the component ID associated with the nodes.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> flag on error
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802649"></a><h3>
<a name="bonobo-ui-engine-xml-get-prop"></a>bonobo_ui_engine_xml_get_prop ()</h3>
<a class="indexterm" name="id2802662"></a><pre class="programlisting">CORBA_char* bonobo_ui_engine_xml_get_prop (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *prop,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> *invalid_path);</pre>
<p>
This function fetches the property <em class="parameter"><code>prop</code></em> at node
at <em class="parameter"><code>path</code></em> in the internal structure.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>prop</code></em> :</span></td>
<td> The property
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>invalid_path</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a CORBA allocated string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802801"></a><h3>
<a name="bonobo-ui-engine-prune-widget-info"></a>bonobo_ui_engine_prune_widget_info ()</h3>
<a class="indexterm" name="id2802815"></a><pre class="programlisting">void bonobo_ui_engine_prune_widget_info
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> save_custom);</pre>
<p>
This function destroys any widgets associated with
<em class="parameter"><code>node</code></em> and all its children, if <em class="parameter"><code>save_custom</code></em>, any widget
that is a custom widget ( such as a control ) will be
preserved. All widgets flagged ROOT are preserved always.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>save_custom</code></em> :</span></td>
<td> whether to save custom widgets
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2802925"></a><h3>
<a name="bonobo-ui-engine-get-path"></a>bonobo_ui_engine_get_path ()</h3>
<a class="indexterm" name="id2802939"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_engine_get_path (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);</pre>
<p>
This routine gets a node from the internal XML tree
pointed at by <em class="parameter"><code>path</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the node.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803027"></a><h3>
<a name="bonobo-ui-engine-dirty-tree"></a>bonobo_ui_engine_dirty_tree ()</h3>
<a class="indexterm" name="id2803040"></a><pre class="programlisting">void bonobo_ui_engine_dirty_tree (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Mark all the node's children as being dirty and needing
a re-synch with their widget views.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803113"></a><h3>
<a name="bonobo-ui-engine-clean-tree"></a>bonobo_ui_engine_clean_tree ()</h3>
<a class="indexterm" name="id2803127"></a><pre class="programlisting">void bonobo_ui_engine_clean_tree (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
This cleans the tree, marking the node and its children
as not needing a re-synch with their widget views.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803200"></a><h3>
<a name="bonobo-ui-engine-dump"></a>bonobo_ui_engine_dump ()</h3>
<a class="indexterm" name="id2803214"></a><pre class="programlisting">void bonobo_ui_engine_dump (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
FILE *out,
const char *msg);</pre>
<p>
This is a debugging function mostly for internal
and testing use, it dumps the XML tree, including
the associated, and overridden nodes in a wierd
hackish format to the <em class="parameter"><code>out</code></em> stream with the
helpful <em class="parameter"><code>msg</code></em> prepended.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>out</code></em> :</span></td>
<td> the FILE stream to dump to
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>msg</code></em> :</span></td>
<td> user visible message
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803322"></a><h3>
<a name="bonobo-ui-engine-node-get-object"></a>bonobo_ui_engine_node_get_object ()</h3>
<a class="indexterm" name="id2803336"></a><pre class="programlisting">CORBA_Object bonobo_ui_engine_node_get_object
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the CORBA_Object associated with a <em class="parameter"><code>node</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803425"></a><h3>
<a name="bonobo-ui-engine-node-is-dirty"></a>bonobo_ui_engine_node_is_dirty ()</h3>
<a class="indexterm" name="id2803439"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_ui_engine_node_is_dirty (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> whether the <em class="parameter"><code>node</code></em> is marked dirty
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803527"></a><h3>
<a name="bonobo-ui-engine-node-get-widget"></a>bonobo_ui_engine_node_get_widget ()</h3>
<a class="indexterm" name="id2803540"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* bonobo_ui_engine_node_get_widget
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Gets the widget associated with <em class="parameter"><code>node</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803629"></a><h3>
<a name="bonobo-ui-engine-node-get-id"></a>bonobo_ui_engine_node_get_id ()</h3>
<a class="indexterm" name="id2803643"></a><pre class="programlisting">const char* bonobo_ui_engine_node_get_id (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Each component has an associated textual id or name - see
bonobo_ui_engine_register_component</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the component id associated with the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803729"></a><h3>
<a name="bonobo-ui-engine-get-cmd-node"></a>bonobo_ui_engine_get_cmd_node ()</h3>
<a class="indexterm" name="id2803742"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_engine_get_cmd_node (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *from_node);</pre>
<p>
This function seeks the command node associated
with <em class="parameter"><code>from_node</code></em> in <em class="parameter"><code>engine</code></em> 's internal tree.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>from_node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the command node or NULL
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803838"></a><h3>
<a name="bonobo-ui-engine-node-set-dirty"></a>bonobo_ui_engine_node_set_dirty ()</h3>
<a class="indexterm" name="id2803852"></a><pre class="programlisting">void bonobo_ui_engine_node_set_dirty (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> dirty);</pre>
<p>
Set <em class="parameter"><code>node</code></em> s dirty bit to <em class="parameter"><code>dirty</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dirty</code></em> :</span></td>
<td> whether the node should be dirty.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803958"></a><h3>
<a name="bonobo-ui-engine-stamp-custom"></a>bonobo_ui_engine_stamp_custom ()</h3>
<a class="indexterm" name="id2803972"></a><pre class="programlisting">void bonobo_ui_engine_stamp_custom (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Marks a node as containing a custom widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804044"></a><h3>
<a name="bonobo-ui-engine-widget-set"></a>bonobo_ui_engine_widget_set ()</h3>
<a class="indexterm" name="id2804058"></a><pre class="programlisting">void bonobo_ui_engine_widget_set (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804146"></a><h3>
<a name="bonobo-ui-engine-stamp-root"></a>bonobo_ui_engine_stamp_root ()</h3>
<a class="indexterm" name="id2804160"></a><pre class="programlisting">void bonobo_ui_engine_stamp_root (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);</pre>
<p>
This stamps <em class="parameter"><code>node</code></em> with <em class="parameter"><code>widget</code></em> which is marked as
being a ROOT node, so the engine will never destroy
it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the root widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804266"></a><h3>
<a name="bonobo-ui-engine-add-hint"></a>bonobo_ui_engine_add_hint ()</h3>
<a class="indexterm" name="id2804280"></a><pre class="programlisting">void bonobo_ui_engine_add_hint (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *str);</pre>
<p>
This fires the 'add_hint' signal.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td> the hint string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804352"></a><h3>
<a name="bonobo-ui-engine-remove-hint"></a>bonobo_ui_engine_remove_hint ()</h3>
<a class="indexterm" name="id2804365"></a><pre class="programlisting">void bonobo_ui_engine_remove_hint (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine);</pre>
<p>
This fires the 'remove_hint' signal</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804416"></a><h3>
<a name="bonobo-ui-engine-emit-verb-on"></a>bonobo_ui_engine_emit_verb_on ()</h3>
<a class="indexterm" name="id2804429"></a><pre class="programlisting">void bonobo_ui_engine_emit_verb_on (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
This fires the 'emit_verb' signal</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804502"></a><h3>
<a name="bonobo-ui-engine-emit-event-on"></a>bonobo_ui_engine_emit_event_on ()</h3>
<a class="indexterm" name="id2804516"></a><pre class="programlisting">void bonobo_ui_engine_emit_event_on (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *state);</pre>
<p>
This fires the 'emit_event_on' signal</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>state</code></em> :</span></td>
<td> the new state of the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804610"></a><h3>
<a name="bonobo-ui-engine-emit-verb-on-w"></a>bonobo_ui_engine_emit_verb_on_w ()</h3>
<a class="indexterm" name="id2804623"></a><pre class="programlisting">void bonobo_ui_engine_emit_verb_on_w (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget);</pre>
<p>
This function looks up the node from <em class="parameter"><code>widget</code></em> and
emits the 'emit_verb_on' signal on that node.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804702"></a><h3>
<a name="bonobo-ui-engine-emit-event-on-w"></a>bonobo_ui_engine_emit_event_on_w ()</h3>
<a class="indexterm" name="id2804716"></a><pre class="programlisting">void bonobo_ui_engine_emit_event_on_w
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
const char *state);</pre>
<p>
This function looks up the node from <em class="parameter"><code>widget</code></em> and
emits the 'emit_event_on' signal on that node
passint <em class="parameter"><code>state</code></em> as the new state.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>state</code></em> :</span></td>
<td> the new state
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804824"></a><h3>
<a name="bonobo-ui-engine-get-attr"></a>bonobo_ui_engine_get_attr ()</h3>
<a class="indexterm" name="id2804838"></a><pre class="programlisting">char* bonobo_ui_engine_get_attr (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *cmd_node,
const char *attr);</pre>
<p>
This function is used to get node attributes in many
UI synchronizers, it first attempts to get the attribute
from <em class="parameter"><code>node</code></em>, and if this fails falls back to <em class="parameter"><code>cmd_node</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cmd_node</code></em> :</span></td>
<td> the command's node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>attr</code></em> :</span></td>
<td> the attribute name
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the attr or NULL if it doesn't exist.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804957"></a><h3>
<a name="bonobo-ui-engine-widget-attach-node"></a>bonobo_ui_engine_widget_attach_node ()</h3>
<a class="indexterm" name="id2804971"></a><pre class="programlisting">void bonobo_ui_engine_widget_attach_node
(<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *widget,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Associate <em class="parameter"><code>node</code></em> with <em class="parameter"><code>widget</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> the widget
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805054"></a><h3>
<a name="bonobo-ui-engine-xml-get"></a>bonobo_ui_engine_xml_get ()</h3>
<a class="indexterm" name="id2805067"></a><pre class="programlisting">CORBA_char* bonobo_ui_engine_xml_get (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> node_only);</pre>
<p>
This function fetches the node at <em class="parameter"><code>path</code></em> in the
internal structure, and if <em class="parameter"><code>node_only</code></em> dumps the
node to an XML string, otherwise it dumps it and
its children.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>node_only</code></em> :</span></td>
<td> just the node, or children too.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the XML string - use CORBA_free to free
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805186"></a><h3>
<a name="bonobo-ui-engine-xml-node-exists"></a>bonobo_ui_engine_xml_node_exists ()</h3>
<a class="indexterm" name="id2805200"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_ui_engine_xml_node_exists
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> true if the node at <em class="parameter"><code>path</code></em> exists
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805289"></a><h3>
<a name="bonobo-ui-engine-xml-merge-tree"></a>bonobo_ui_engine_xml_merge_tree ()</h3>
<a class="indexterm" name="id2805303"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> bonobo_ui_engine_xml_merge_tree
(<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *tree,
const char *component);</pre>
<p>
This function merges the XML <em class="parameter"><code>tree</code></em> into the internal tree
representation as children of the node at <em class="parameter"><code>path</code></em> in <em class="parameter"><code>engine</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tree</code></em> :</span></td>
<td> the nodes
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>component</code></em> :</span></td>
<td> the component ID associated with these nodes.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> flag on error
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805450"></a><h3>
<a name="bonobo-ui-engine-xml-rm"></a>bonobo_ui_engine_xml_rm ()</h3>
<a class="indexterm" name="id2805463"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> bonobo_ui_engine_xml_rm (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
const char *by_component);</pre>
<p>
Remove a chunk of the xml tree pointed at by <em class="parameter"><code>path</code></em>
in <em class="parameter"><code>engine</code></em>, if <em class="parameter"><code>by_component</code></em> then only remove items
associated with that component - possibly revealing
other overridden items.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>by_component</code></em> :</span></td>
<td> whether to remove elements from only a
specific component
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> flag on error
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805588"></a><h3>
<a name="bonobo-ui-engine-object-set"></a>bonobo_ui_engine_object_set ()</h3>
<a class="indexterm" name="id2805602"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> bonobo_ui_engine_object_set (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
Bonobo_Unknown object,
CORBA_Environment *ev);</pre>
<p>
This associates a CORBA Object reference with a node
in the tree, most often this is done to insert a Control's
reference into a 'control' element.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
<td> an object reference
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td> CORBA exception environment
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> flag if success
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805731"></a><h3>
<a name="bonobo-ui-engine-object-get"></a>bonobo_ui_engine_object_get ()</h3>
<a class="indexterm" name="id2805745"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-engine.html#BonoboUIError">BonoboUIError</a> bonobo_ui_engine_object_get (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const char *path,
Bonobo_Unknown *object,
CORBA_Environment *ev);</pre>
<p>
This extracts a CORBA object reference associated with
the node at <em class="parameter"><code>path</code></em> in <em class="parameter"><code>engine</code></em>, and returns it in the
reference pointed to by <em class="parameter"><code>object</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td> the engine
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em> :</span></td>
<td> the path into the tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
<td> an pointer to an object reference
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td> CORBA exception environment
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> flag if success
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805892"></a><h3>
<a name="bonobo-ui-engine-exec-verb"></a>bonobo_ui_engine_exec_verb ()</h3>
<a class="indexterm" name="id2805906"></a><pre class="programlisting">void bonobo_ui_engine_exec_verb (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const CORBA_char *cname,
CORBA_Environment *ev);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cname</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2805994"></a><h3>
<a name="bonobo-ui-engine-ui-event"></a>bonobo_ui_engine_ui_event ()</h3>
<a class="indexterm" name="id2806008"></a><pre class="programlisting">void bonobo_ui_engine_ui_event (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *engine,
const CORBA_char *id,
const Bonobo_UIComponent_EventType type,
const CORBA_char *state,
CORBA_Environment *ev);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>engine</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>id</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>state</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2806141"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id2806151"></a><h3>
<a name="BonoboUIEngine-add-hint"></a>The "add-hint" signal</h3>
<a class="indexterm" name="id2806162"></a><pre class="programlisting">void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bonobouiengine</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2806252"></a><h3>
<a name="BonoboUIEngine-destroy"></a>The "destroy" signal</h3>
<a class="indexterm" name="id2806262"></a><pre class="programlisting">void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bonobouiengine</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2806331"></a><h3>
<a name="BonoboUIEngine-emit-event-on"></a>The "emit-event-on" signal</h3>
<a class="indexterm" name="id2806342"></a><pre class="programlisting">void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg2,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bonobouiengine</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg2</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2806454"></a><h3>
<a name="BonoboUIEngine-emit-verb-on"></a>The "emit-verb-on" signal</h3>
<a class="indexterm" name="id2806464"></a><pre class="programlisting">void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bonobouiengine</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2806555"></a><h3>
<a name="BonoboUIEngine-remove-hint"></a>The "remove-hint" signal</h3>
<a class="indexterm" name="id2806565"></a><pre class="programlisting">void user_function (<a href="libbonoboui-bonobo-ui-engine.html#BonoboUIEngine">BonoboUIEngine</a> *bonobouiengine,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bonobouiengine</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>