~ubuntu-branches/ubuntu/precise/libbonoboui/precise

« back to all changes in this revision

Viewing changes to doc/api/html/libbonoboui-bonobo-ui-component.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-30 13:42:51 UTC
  • mfrom: (1.1.24 upstream)
  • Revision ID: james.westby@ubuntu.com-20100330134251-9zf96pnsqm4qxb3t
Tags: 2.24.3-0ubuntu1
* New upstream version:
  - Skip unknown accelerators 
  - Don't pass NULL to G_OBJECT_GET_CLASS
  - Updated translations 

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="bonobo-ui.html" title="Bonobo UI">
9
9
<link rel="prev" href="libbonoboui-bonobo-window.html" title="bonobo-window">
10
10
<link rel="next" href="libbonoboui-bonobo-ui-container.html" title="BonoboUIContainer">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
14
14
<link rel="chapter" href="bonobo-controls.html" title="Controls">
27
27
</tr>
28
28
<tr><td colspan="5" class="shortcuts">
29
29
<a href="#libbonoboui-bonobo-ui-component.synopsis" class="shortcut">Top</a>
30
 
                 | 
31
 
                <a href="#libbonoboui-bonobo-ui-component.description" class="shortcut">Description</a>
32
 
                 | 
33
 
                <a href="#libbonoboui-bonobo-ui-component.object-hierarchy" class="shortcut">Object Hierarchy</a>
34
 
                 | 
35
 
                <a href="#libbonoboui-bonobo-ui-component.signals" class="shortcut">Signals</a>
 
30
                   | 
 
31
                  <a href="#libbonoboui-bonobo-ui-component.description" class="shortcut">Description</a>
 
32
                   | 
 
33
                  <a href="#libbonoboui-bonobo-ui-component.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
34
                   | 
 
35
                  <a href="#libbonoboui-bonobo-ui-component.signals" class="shortcut">Signals</a>
36
36
</td></tr>
37
37
</table>
38
38
<div class="refentry" title="BonoboUIComponent">
46
46
</tr></table></div>
47
47
<div class="refsynopsisdiv" title="Synopsis">
48
48
<a name="libbonoboui-bonobo-ui-component.synopsis"></a><h2>Synopsis</h2>
49
 
<a name="BonoboUIComponent"></a><pre class="synopsis">
50
 
                    <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent-struct" title="BonoboUIComponent">BonoboUIComponent</a>;
 
49
<a name="BonoboUIComponent"></a><pre class="synopsis">                    <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent-struct" title="BonoboUIComponent">BonoboUIComponent</a>;
51
50
                    <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponentPrivate" title="BonoboUIComponentPrivate">BonoboUIComponentPrivate</a>;
52
 
void                (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()">*BonoboUIListenerFn</a>)               (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
53
 
                                                         const char *path,
54
 
                                                         Bonobo_UIComponent_EventType type,
55
 
                                                         const char *state,
56
 
                                                         <a
57
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
58
 
>gpointer</a> user_data);
59
 
void                (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()">*BonoboUIVerbFn</a>)                   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
60
 
                                                         <a
61
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
62
 
>gpointer</a> user_data,
63
 
                                                         const char *cname);
 
51
<span class="returnvalue">void</span>                (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()">*BonoboUIListenerFn</a>)               (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
52
                                                         const <span class="returnvalue">char</span> *path,
 
53
                                                         <span class="returnvalue">Bonobo_UIComponent_EventType</span> type,
 
54
                                                         const <span class="returnvalue">char</span> *state,
 
55
                                                         <span class="returnvalue">gpointer</span> user_data);
 
56
<span class="returnvalue">void</span>                (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()">*BonoboUIVerbFn</a>)                   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
57
                                                         <span class="returnvalue">gpointer</span> user_data,
 
58
                                                         const <span class="returnvalue">char</span> *cname);
64
59
                    <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponentClass" title="BonoboUIComponentClass">BonoboUIComponentClass</a>;
65
 
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-construct" title="bonobo_ui_component_construct ()">bonobo_ui_component_construct</a>       (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
66
 
                                                         const char *name);
67
 
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-new" title="bonobo_ui_component_new ()">bonobo_ui_component_new</a>             (const char *name);
68
 
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-new-default" title="bonobo_ui_component_new_default ()">bonobo_ui_component_new_default</a>     (void);
69
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-name" title="bonobo_ui_component_set_name ()">bonobo_ui_component_set_name</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
70
 
                                                         const char *name);
71
 
const char *        <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-name" title="bonobo_ui_component_get_name ()">bonobo_ui_component_get_name</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component);
72
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-container" title="bonobo_ui_component_set_container ()">bonobo_ui_component_set_container</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
73
 
                                                         Bonobo_UIContainer container,
74
 
                                                         CORBA_Environment *opt_ev);
75
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-unset-container" title="bonobo_ui_component_unset_container ()">bonobo_ui_component_unset_container</a> (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
76
 
                                                         CORBA_Environment *opt_ev);
77
 
Bonobo_UIContainer  <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-container" title="bonobo_ui_component_get_container ()">bonobo_ui_component_get_container</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component);
78
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb" title="bonobo_ui_component_add_verb ()">bonobo_ui_component_add_verb</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
79
 
                                                         const char *cname,
80
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()">BonoboUIVerbFn</a> fn,
81
 
                                                         <a
82
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
83
 
>gpointer</a> user_data);
84
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-full" title="bonobo_ui_component_add_verb_full ()">bonobo_ui_component_add_verb_full</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
85
 
                                                         const char *cname,
86
 
                                                         <a
87
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
88
 
>GClosure</a> *closure);
89
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-verb" title="bonobo_ui_component_remove_verb ()">bonobo_ui_component_remove_verb</a>     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
90
 
                                                         const char *cname);
91
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-verb-by-closure" title="bonobo_ui_component_remove_verb_by_closure ()">bonobo_ui_component_remove_verb_by_closure</a>
92
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
93
 
                                                         <a
94
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
95
 
>GClosure</a> *closure);
96
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-listener" title="bonobo_ui_component_add_listener ()">bonobo_ui_component_add_listener</a>    (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
97
 
                                                         const char *id,
98
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()">BonoboUIListenerFn</a> fn,
99
 
                                                         <a
100
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
101
 
>gpointer</a> user_data);
102
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-listener-full" title="bonobo_ui_component_add_listener_full ()">bonobo_ui_component_add_listener_full</a>
103
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
104
 
                                                         const char *id,
105
 
                                                         <a
106
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
107
 
>GClosure</a> *closure);
108
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-listener" title="bonobo_ui_component_remove_listener ()">bonobo_ui_component_remove_listener</a> (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
109
 
                                                         const char *cname);
110
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-listener-by-closure" title="bonobo_ui_component_remove_listener_by_closure ()">bonobo_ui_component_remove_listener_by_closure</a>
111
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
112
 
                                                         <a
113
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
114
 
>GClosure</a> *closure);
115
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set" title="bonobo_ui_component_set ()">bonobo_ui_component_set</a>             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
116
 
                                                         const char *path,
117
 
                                                         const char *xml,
118
 
                                                         CORBA_Environment *opt_ev);
119
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-translate" title="bonobo_ui_component_set_translate ()">bonobo_ui_component_set_translate</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
120
 
                                                         const char *path,
121
 
                                                         const char *xml,
122
 
                                                         CORBA_Environment *opt_ev);
123
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-tree" title="bonobo_ui_component_set_tree ()">bonobo_ui_component_set_tree</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
124
 
                                                         const char *path,
125
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode">BonoboUINode</a> *node,
126
 
                                                         CORBA_Environment *ev);
127
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-rm" title="bonobo_ui_component_rm ()">bonobo_ui_component_rm</a>              (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
128
 
                                                         const char *path,
129
 
                                                         CORBA_Environment *ev);
130
 
<a
131
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
132
 
>gboolean</a>            <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-path-exists" title="bonobo_ui_component_path_exists ()">bonobo_ui_component_path_exists</a>     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
133
 
                                                         const char *path,
134
 
                                                         CORBA_Environment *ev);
135
 
CORBA_char *        <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get" title="bonobo_ui_component_get ()">bonobo_ui_component_get</a>             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
136
 
                                                         const char *path,
137
 
                                                         <a
138
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
139
 
>gboolean</a> recurse,
140
 
                                                         CORBA_Environment *opt_ev);
141
 
<a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode">BonoboUINode</a> *      <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-tree" title="bonobo_ui_component_get_tree ()">bonobo_ui_component_get_tree</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
142
 
                                                         const char *path,
143
 
                                                         <a
144
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
145
 
>gboolean</a> recurse,
146
 
                                                         CORBA_Environment *opt_ev);
147
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-object-set" title="bonobo_ui_component_object_set ()">bonobo_ui_component_object_set</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
148
 
                                                         const char *path,
149
 
                                                         Bonobo_Unknown control,
150
 
                                                         CORBA_Environment *opt_ev);
151
 
Bonobo_Unknown      <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-object-get" title="bonobo_ui_component_object_get ()">bonobo_ui_component_object_get</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
152
 
                                                         const char *path,
153
 
                                                         CORBA_Environment *opt_ev);
154
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-widget-set" title="bonobo_ui_component_widget_set ()">bonobo_ui_component_widget_set</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
155
 
                                                         const char *path,
156
 
                                                         <a
157
 
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
158
 
>GtkWidget</a> *widget,
159
 
                                                         CORBA_Environment *opt_ev);
160
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-freeze" title="bonobo_ui_component_freeze ()">bonobo_ui_component_freeze</a>          (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
161
 
                                                         CORBA_Environment *opt_ev);
162
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-thaw" title="bonobo_ui_component_thaw ()">bonobo_ui_component_thaw</a>            (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
163
 
                                                         CORBA_Environment *opt_ev);
164
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-prop" title="bonobo_ui_component_set_prop ()">bonobo_ui_component_set_prop</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
165
 
                                                         const char *path,
166
 
                                                         const char *prop,
167
 
                                                         const char *value,
168
 
                                                         CORBA_Environment *opt_ev);
169
 
<a
170
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
171
 
>gchar</a> *             <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-prop" title="bonobo_ui_component_get_prop ()">bonobo_ui_component_get_prop</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
172
 
                                                         const char *path,
173
 
                                                         const char *prop,
174
 
                                                         CORBA_Environment *opt_ev);
175
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-status" title="bonobo_ui_component_set_status ()">bonobo_ui_component_set_status</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
176
 
                                                         const char *text,
177
 
                                                         CORBA_Environment *opt_ev);
 
60
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-construct" title="bonobo_ui_component_construct ()">bonobo_ui_component_construct</a>       (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
61
                                                         const <span class="returnvalue">char</span> *name);
 
62
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-new" title="bonobo_ui_component_new ()">bonobo_ui_component_new</a>             (const <span class="returnvalue">char</span> *name);
 
63
<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-new-default" title="bonobo_ui_component_new_default ()">bonobo_ui_component_new_default</a>     (void);
 
64
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-name" title="bonobo_ui_component_set_name ()">bonobo_ui_component_set_name</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
65
                                                         const <span class="returnvalue">char</span> *name);
 
66
const <span class="returnvalue">char</span> *        <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-name" title="bonobo_ui_component_get_name ()">bonobo_ui_component_get_name</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component);
 
67
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-container" title="bonobo_ui_component_set_container ()">bonobo_ui_component_set_container</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
68
                                                         <span class="returnvalue">Bonobo_UIContainer</span> container,
 
69
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
70
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-unset-container" title="bonobo_ui_component_unset_container ()">bonobo_ui_component_unset_container</a> (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
71
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
72
<span class="returnvalue">Bonobo_UIContainer</span>  <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-container" title="bonobo_ui_component_get_container ()">bonobo_ui_component_get_container</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component);
 
73
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb" title="bonobo_ui_component_add_verb ()">bonobo_ui_component_add_verb</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
74
                                                         const <span class="returnvalue">char</span> *cname,
 
75
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()"><span class="returnvalue">BonoboUIVerbFn</span></a> fn,
 
76
                                                         <span class="returnvalue">gpointer</span> user_data);
 
77
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-full" title="bonobo_ui_component_add_verb_full ()">bonobo_ui_component_add_verb_full</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
78
                                                         const <span class="returnvalue">char</span> *cname,
 
79
                                                         <span class="returnvalue">GClosure</span> *closure);
 
80
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-verb" title="bonobo_ui_component_remove_verb ()">bonobo_ui_component_remove_verb</a>     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
81
                                                         const <span class="returnvalue">char</span> *cname);
 
82
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-verb-by-closure" title="bonobo_ui_component_remove_verb_by_closure ()">bonobo_ui_component_remove_verb_by_closure</a>
 
83
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
84
                                                         <span class="returnvalue">GClosure</span> *closure);
 
85
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-listener" title="bonobo_ui_component_add_listener ()">bonobo_ui_component_add_listener</a>    (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
86
                                                         const <span class="returnvalue">char</span> *id,
 
87
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()"><span class="returnvalue">BonoboUIListenerFn</span></a> fn,
 
88
                                                         <span class="returnvalue">gpointer</span> user_data);
 
89
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-listener-full" title="bonobo_ui_component_add_listener_full ()">bonobo_ui_component_add_listener_full</a>
 
90
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
91
                                                         const <span class="returnvalue">char</span> *id,
 
92
                                                         <span class="returnvalue">GClosure</span> *closure);
 
93
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-listener" title="bonobo_ui_component_remove_listener ()">bonobo_ui_component_remove_listener</a> (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
94
                                                         const <span class="returnvalue">char</span> *cname);
 
95
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-remove-listener-by-closure" title="bonobo_ui_component_remove_listener_by_closure ()">bonobo_ui_component_remove_listener_by_closure</a>
 
96
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
97
                                                         <span class="returnvalue">GClosure</span> *closure);
 
98
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set" title="bonobo_ui_component_set ()">bonobo_ui_component_set</a>             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
99
                                                         const <span class="returnvalue">char</span> *path,
 
100
                                                         const <span class="returnvalue">char</span> *xml,
 
101
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
102
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-translate" title="bonobo_ui_component_set_translate ()">bonobo_ui_component_set_translate</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
103
                                                         const <span class="returnvalue">char</span> *path,
 
104
                                                         const <span class="returnvalue">char</span> *xml,
 
105
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
106
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-tree" title="bonobo_ui_component_set_tree ()">bonobo_ui_component_set_tree</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
107
                                                         const <span class="returnvalue">char</span> *path,
 
108
                                                         <a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode"><span class="returnvalue">BonoboUINode</span></a> *node,
 
109
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);
 
110
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-rm" title="bonobo_ui_component_rm ()">bonobo_ui_component_rm</a>              (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
111
                                                         const <span class="returnvalue">char</span> *path,
 
112
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);
 
113
<span class="returnvalue">gboolean</span>            <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-path-exists" title="bonobo_ui_component_path_exists ()">bonobo_ui_component_path_exists</a>     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
114
                                                         const <span class="returnvalue">char</span> *path,
 
115
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);
 
116
<span class="returnvalue">CORBA_char</span> *        <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get" title="bonobo_ui_component_get ()">bonobo_ui_component_get</a>             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
117
                                                         const <span class="returnvalue">char</span> *path,
 
118
                                                         <span class="returnvalue">gboolean</span> recurse,
 
119
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
120
<a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode"><span class="returnvalue">BonoboUINode</span></a> *      <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-tree" title="bonobo_ui_component_get_tree ()">bonobo_ui_component_get_tree</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
121
                                                         const <span class="returnvalue">char</span> *path,
 
122
                                                         <span class="returnvalue">gboolean</span> recurse,
 
123
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
124
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-object-set" title="bonobo_ui_component_object_set ()">bonobo_ui_component_object_set</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
125
                                                         const <span class="returnvalue">char</span> *path,
 
126
                                                         <span class="returnvalue">Bonobo_Unknown</span> control,
 
127
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
128
<span class="returnvalue">Bonobo_Unknown</span>      <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-object-get" title="bonobo_ui_component_object_get ()">bonobo_ui_component_object_get</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
129
                                                         const <span class="returnvalue">char</span> *path,
 
130
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
131
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-widget-set" title="bonobo_ui_component_widget_set ()">bonobo_ui_component_widget_set</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
132
                                                         const <span class="returnvalue">char</span> *path,
 
133
                                                         <span class="returnvalue">GtkWidget</span> *widget,
 
134
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
135
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-freeze" title="bonobo_ui_component_freeze ()">bonobo_ui_component_freeze</a>          (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
136
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
137
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-thaw" title="bonobo_ui_component_thaw ()">bonobo_ui_component_thaw</a>            (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
138
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
139
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-prop" title="bonobo_ui_component_set_prop ()">bonobo_ui_component_set_prop</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
140
                                                         const <span class="returnvalue">char</span> *path,
 
141
                                                         const <span class="returnvalue">char</span> *prop,
 
142
                                                         const <span class="returnvalue">char</span> *value,
 
143
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
144
<span class="returnvalue">gchar</span> *             <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-get-prop" title="bonobo_ui_component_get_prop ()">bonobo_ui_component_get_prop</a>        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
145
                                                         const <span class="returnvalue">char</span> *path,
 
146
                                                         const <span class="returnvalue">char</span> *prop,
 
147
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
148
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-status" title="bonobo_ui_component_set_status ()">bonobo_ui_component_set_status</a>      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
149
                                                         const <span class="returnvalue">char</span> *text,
 
150
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
178
151
                    <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb">BonoboUIVerb</a>;
179
 
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB--CAPS" title="BONOBO_UI_VERB()">BONOBO_UI_VERB</a>                      (name,cb)
180
 
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-DATA--CAPS" title="BONOBO_UI_VERB_DATA()">BONOBO_UI_VERB_DATA</a>                 (name,cb,data)
181
 
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-UNSAFE-VERB--CAPS" title="BONOBO_UI_UNSAFE_VERB()">BONOBO_UI_UNSAFE_VERB</a>               (name,cb)
182
 
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-UNSAFE-VERB-DATA--CAPS" title="BONOBO_UI_UNSAFE_VERB_DATA()">BONOBO_UI_UNSAFE_VERB_DATA</a>          (name,cb,data)
183
 
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-END--CAPS" title="BONOBO_UI_VERB_END">BONOBO_UI_VERB_END</a>
184
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-list" title="bonobo_ui_component_add_verb_list ()">bonobo_ui_component_add_verb_list</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
185
 
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb">BonoboUIVerb</a> *list);
186
 
void                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-list-with-data" title="bonobo_ui_component_add_verb_list_with_data ()">bonobo_ui_component_add_verb_list_with_data</a>
187
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
188
 
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb">BonoboUIVerb</a> *list,
189
 
                                                         <a
190
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
191
 
>gpointer</a> user_data);
 
152
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB:CAPS" title="BONOBO_UI_VERB()">BONOBO_UI_VERB</a>                      (name,cb)
 
153
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-DATA:CAPS" title="BONOBO_UI_VERB_DATA()">BONOBO_UI_VERB_DATA</a>                 (name,cb,data)
 
154
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-UNSAFE-VERB:CAPS" title="BONOBO_UI_UNSAFE_VERB()">BONOBO_UI_UNSAFE_VERB</a>               (name,cb)
 
155
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-UNSAFE-VERB-DATA:CAPS" title="BONOBO_UI_UNSAFE_VERB_DATA()">BONOBO_UI_UNSAFE_VERB_DATA</a>          (name,cb,data)
 
156
#define             <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-END:CAPS" title="BONOBO_UI_VERB_END">BONOBO_UI_VERB_END</a>
 
157
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-list" title="bonobo_ui_component_add_verb_list ()">bonobo_ui_component_add_verb_list</a>   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
158
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="returnvalue">BonoboUIVerb</span></a> *list);
 
159
<span class="returnvalue">void</span>                <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-list-with-data" title="bonobo_ui_component_add_verb_list_with_data ()">bonobo_ui_component_add_verb_list_with_data</a>
 
160
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
161
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="returnvalue">BonoboUIVerb</span></a> *list,
 
162
                                                         <span class="returnvalue">gpointer</span> user_data);
192
163
</pre>
193
164
</div>
194
165
<div class="refsect1" title="Object Hierarchy">
195
166
<a name="libbonoboui-bonobo-ui-component.object-hierarchy"></a><h2>Object Hierarchy</h2>
196
167
<pre class="synopsis">
197
 
  <a
198
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
199
 
>GObject</a>
200
 
   +----<a
201
 
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-object.html#BonoboObject"
202
 
>BonoboObject</a>
 
168
  GObject
 
169
   +----<a href="/gnome/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a>
203
170
         +----BonoboUIComponent
204
171
</pre>
205
172
</div>
228
195
construction time and can be accessed thus:
229
196
  </p>
230
197
<div class="example">
231
 
<a name="id2742908"></a><p class="title"><b>Example 4. Using the UI Component associated with a control</b></p>
232
 
<div class="example-contents"><pre class="programlisting">
233
 
/*
234
 
 * For the format of the XML see bonobo/doc/xml-ui.txt
235
 
 * For a standard template to base your UI on see bonobo/doc/std-ui.xml
236
 
 */
237
 
const char my_ui_elements [] =
238
 
        "&gt;placeholder name=\"FileOps\"&lt;"
239
 
        "       &gt;menuitem name=\"Foo\" verb=\"FileFoo\" _label=\"Foo!\""
240
 
        "        _tip=\"do some foo thing\"/&lt;"
241
 
        "&gt;/placeholder&lt;";
242
 
static void
 
198
<a name="id2610490"></a><p class="title"><b>Example 4. Using the UI Component associated with a control</b></p>
 
199
<div class="example-contents">
 
200
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
201
    <tbody>
 
202
      <tr>
 
203
        <td class="listing_lines" align="right"><pre>1
 
204
2
 
205
3
 
206
4
 
207
5
 
208
6
 
209
7
 
210
8
 
211
9
 
212
10
 
213
11
 
214
12
 
215
13
 
216
14
 
217
15
 
218
16
 
219
17
 
220
18
 
221
19
 
222
20
 
223
21
 
224
22
 
225
23
 
226
24
 
227
25
 
228
26
 
229
27
 
230
28
 
231
29
 
232
30
 
233
31
 
234
32
 
235
33
 
236
34
 
237
35
 
238
36
 
239
37
 
240
38
 
241
39
 
242
40
 
243
41
 
244
42
 
245
43
 
246
44
 
247
45
 
248
46
 
249
47
 
250
48
 
251
49
 
252
50
 
253
51
 
254
52
 
255
53</pre></td>
 
256
        <td class="listing_code"><pre class="programlisting"><span class="comment">/*</span>
 
257
<span class="comment"> * For the format of the XML see bonobo/doc/xml-ui.txt</span>
 
258
<span class="comment"> * For a standard template to base your UI on see bonobo/doc/std-ui.xml</span>
 
259
<span class="comment"> </span><span class="comment">*/</span>
 
260
<span class="type">const</span> <span class="type">char</span> my_ui_elements [] =
 
261
        <span class="number">&quot;&gt;placeholder name=</span><span class="symbol">\&quot;</span><span class="number">FileOps</span><span class="symbol">\&quot;</span><span class="number">&lt;&quot;</span>
 
262
        <span class="number">&quot;      &gt;menuitem name=</span><span class="symbol">\&quot;</span><span class="number">Foo</span><span class="symbol">\&quot;</span><span class="number"> verb=</span><span class="symbol">\&quot;</span><span class="number">FileFoo</span><span class="symbol">\&quot;</span><span class="number"> _label=</span><span class="symbol">\&quot;</span><span class="number">Foo!</span><span class="symbol">\&quot;</span><span class="number">&quot;</span>
 
263
        <span class="number">&quot;       _tip=</span><span class="symbol">\&quot;</span><span class="number">do some foo thing</span><span class="symbol">\&quot;</span><span class="number">/&lt;&quot;</span>
 
264
        <span class="number">&quot;&gt;/placeholder&lt;&quot;</span>;
 
265
<span class="type">static</span> <span class="type">void</span>
243
266
control_activate_cb (BonoboControl *object,
244
267
                     gboolean       state,
245
 
                     gpointer       user_data)
 
268
                     gpointer       user_data)
246
269
{
247
 
        BonoboUIComponent *ui_component;
248
 
        /* Get UIComponent from control */
249
 
        ui_component = bonobo_control_get_ui_component (control);
250
 
        if (state) /* Activate */
251
 
                bonobo_ui_component_set_translate (
252
 
                        ui_component, "/menu/File", my_ui_elements, NULL);
253
 
        else /* De-activate */
254
 
                bonobo_ui_component_unset_container (ui_component);
 
270
        BonoboUIComponent *ui_component;
 
271
        <span class="comment">/*</span><span class="comment"> Get UIComponent from control </span><span class="comment">*/</span>
 
272
        ui_component = bonobo_control_get_ui_component (control);
 
273
        <span class="keyword">if</span> (state) <span class="comment">/*</span><span class="comment"> Activate </span><span class="comment">*/</span>
 
274
                bonobo_ui_component_set_translate (
 
275
                        ui_component, <span class="number">&quot;/menu/File&quot;</span>, my_ui_elements, <span class="number">NULL</span>);
 
276
        <span class="keyword">else</span> <span class="comment">/*</span><span class="comment"> De-activate </span><span class="comment">*/</span>
 
277
                bonobo_ui_component_unset_container (ui_component);
255
278
}
256
 
static void
 
279
<span class="type">static</span> <span class="type">void</span>
257
280
verb_foo_cb (BonoboUIComponent *ui_container,
258
281
             gpointer           user_data,
259
 
             const              char *cname)
 
282
             <span class="type">const</span>              <span class="type">char</span> *cname)
260
283
{
261
 
        BonoboControl *control = user_data;
262
 
        g_print ("FileFoo !\n");
 
284
        BonoboControl *control = user_data;
 
285
        g_print (<span class="number">&quot;FileFoo !</span><span class="symbol">\n</span><span class="number">&quot;</span>);
263
286
}
264
 
static BonoboUIVerb my_ui_verbs[] = {
265
 
        BONOBO_UI_VERB ("FileFoo", verb_foo_cb),
266
 
        BONOBO_UI_VERB_END
 
287
<span class="type">static</span> BonoboUIVerb my_ui_verbs[] = {
 
288
        BONOBO_UI_VERB (<span class="number">&quot;FileFoo&quot;</span>, verb_foo_cb),
 
289
        BONOBO_UI_VERB_END
267
290
};
268
291
BonoboObject *
269
 
create_ui_control (void)
 
292
create_ui_control (<span class="type">void</span>)
270
293
{
271
 
        BonoboControl     *control;
272
 
        BonoboUIComponent *ui_component;
273
 
        GtkWidget         *widget;
274
 
        control = bonobo_control_new ((widget = gtk_widget_new_label ("Hello World")));
275
 
        /* Automaticaly associate the remote UIContainer for us on activate */
276
 
        bonobo_control_set_automerge (control, TRUE);
277
 
        ui_component = bonobo_control_get_ui_component (control);
278
 
        /* Register the verbs with the UI Component */
279
 
        bonobo_ui_component_add_verb_list_with_data (
280
 
                ui_component, my_ui_verbs, control);
281
 
        gtk_signal_connect (GTK_OBJECT (control), "activate",
282
 
                            GTK_SIGNAL_FUNC (control_activate_cb), NULL);
283
 
        gtk_widget_show (widget);
284
 
        return BONOBO_OBJECT (control);
285
 
}
286
 
    </pre></div>
 
294
        BonoboControl     *control;
 
295
        BonoboUIComponent *ui_component;
 
296
        GtkWidget         *widget;
 
297
        control = bonobo_control_new ((widget = gtk_widget_new_label (<span class="number">&quot;Hello World&quot;</span>)));
 
298
        <span class="comment">/*</span><span class="comment"> Automaticaly associate the remote UIContainer for us on activate </span><span class="comment">*/</span>
 
299
        bonobo_control_set_automerge (control, TRUE);
 
300
        ui_component = bonobo_control_get_ui_component (control);
 
301
        <span class="comment">/*</span><span class="comment"> Register the verbs with the UI Component </span><span class="comment">*/</span>
 
302
        bonobo_ui_component_add_verb_list_with_data (
 
303
                ui_component, my_ui_verbs, control);
 
304
        gtk_signal_connect (GTK_OBJECT (control), <span class="number">&quot;activate&quot;</span>,
 
305
                            GTK_SIGNAL_FUNC (control_activate_cb), <span class="number">NULL</span>);
 
306
        gtk_widget_show (widget);
 
307
        <span class="keyword">return</span> BONOBO_OBJECT (control);
 
308
}</pre></td>
 
309
      </tr>
 
310
    </tbody>
 
311
  </table>
 
312
</div>
 
313
 
287
314
</div>
288
315
<p><br class="example-break">
289
316
This sets up the UI, associates a 'FileFoo' verb with a callback, and
305
332
is extremely important. Here is a better activate function:
306
333
  </p>
307
334
<div class="example">
308
 
<a name="id2743003"></a><p class="title"><b>Example 5. A better way to create your UI</b></p>
309
 
<div class="example-contents"><pre class="programlisting">
310
 
static void
 
335
<a name="id2610592"></a><p class="title"><b>Example 5. A better way to create your UI</b></p>
 
336
<div class="example-contents">
 
337
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
338
    <tbody>
 
339
      <tr>
 
340
        <td class="listing_lines" align="right"><pre>1
 
341
2
 
342
3
 
343
4
 
344
5
 
345
6
 
346
7
 
347
8
 
348
9
 
349
10
 
350
11
 
351
12
 
352
13
 
353
14
 
354
15
 
355
16
 
356
17
 
357
18</pre></td>
 
358
        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span>
311
359
control_activate_cb (BonoboControl *object,
312
360
                     gboolean       state,
313
 
                     gpointer       user_data)
 
361
                     gpointer       user_data)
314
362
{
315
 
        BonoboUIComponent *ui_component;
316
 
        /* Get UIComponent from control */
317
 
        ui_component = bonobo_control_get_ui_component (control);
318
 
        if (state) /* Activate */
319
 
                /*
320
 
                 * Use a helper function to setup your UI from a file:
321
 
                 */
322
 
                bonobo_ui_util_set_ui (
323
 
                        ui_component, MY_COMPILE_TIME_PREFIX,
324
 
                        "GNOME_MyApp.ui", "my-app");
325
 
        else /* De-activate */
326
 
                bonobo_ui_component_unset_container (ui_component);
327
 
}
328
 
    </pre></div>
 
363
        BonoboUIComponent *ui_component;
 
364
        <span class="comment">/*</span><span class="comment"> Get UIComponent from control </span><span class="comment">*/</span>
 
365
        ui_component = bonobo_control_get_ui_component (control);
 
366
        <span class="keyword">if</span> (state) <span class="comment">/*</span><span class="comment"> Activate </span><span class="comment">*/</span>
 
367
                <span class="comment">/*</span>
 
368
<span class="comment">                 * Use a helper function to setup your UI from a file:</span>
 
369
<span class="comment">                 </span><span class="comment">*/</span>
 
370
                bonobo_ui_util_set_ui (
 
371
                        ui_component, MY_COMPILE_TIME_PREFIX,
 
372
                        <span class="number">&quot;GNOME_MyApp.ui&quot;</span>, <span class="number">&quot;my-app&quot;</span>);
 
373
        <span class="keyword">else</span> <span class="comment">/*</span><span class="comment"> De-activate </span><span class="comment">*/</span>
 
374
                bonobo_ui_component_unset_container (ui_component);
 
375
}</pre></td>
 
376
      </tr>
 
377
    </tbody>
 
378
  </table>
 
379
</div>
 
380
 
329
381
</div>
330
382
<p><br class="example-break">
331
383
  In this example "GNOME_MyApp.ui" is the correctly namespaced UI
352
404
<hr>
353
405
<div class="refsect2" title="BonoboUIListenerFn ()">
354
406
<a name="BonoboUIListenerFn"></a><h3>BonoboUIListenerFn ()</h3>
355
 
<pre class="programlisting">void                (*BonoboUIListenerFn)               (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
356
 
                                                         const char *path,
357
 
                                                         Bonobo_UIComponent_EventType type,
358
 
                                                         const char *state,
359
 
                                                         <a
360
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
361
 
>gpointer</a> user_data);</pre>
 
407
<pre class="programlisting"><span class="returnvalue">void</span>                (*BonoboUIListenerFn)               (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
408
                                                         const <span class="returnvalue">char</span> *path,
 
409
                                                         <span class="returnvalue">Bonobo_UIComponent_EventType</span> type,
 
410
                                                         const <span class="returnvalue">char</span> *state,
 
411
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
362
412
<p>
363
413
</p>
364
414
<div class="variablelist"><table border="0">
395
445
<hr>
396
446
<div class="refsect2" title="BonoboUIVerbFn ()">
397
447
<a name="BonoboUIVerbFn"></a><h3>BonoboUIVerbFn ()</h3>
398
 
<pre class="programlisting">void                (*BonoboUIVerbFn)                   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
399
 
                                                         <a
400
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
401
 
>gpointer</a> user_data,
402
 
                                                         const char *cname);</pre>
 
448
<pre class="programlisting"><span class="returnvalue">void</span>                (*BonoboUIVerbFn)                   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
449
                                                         <span class="returnvalue">gpointer</span> user_data,
 
450
                                                         const <span class="returnvalue">char</span> *cname);</pre>
403
451
<p>
404
452
</p>
405
453
<div class="variablelist"><table border="0">
484
532
<hr>
485
533
<div class="refsect2" title="bonobo_ui_component_construct ()">
486
534
<a name="bonobo-ui-component-construct"></a><h3>bonobo_ui_component_construct ()</h3>
487
 
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * bonobo_ui_component_construct       (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
488
 
                                                         const char *name);</pre>
 
535
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * bonobo_ui_component_construct       (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
536
                                                         const <span class="returnvalue">char</span> *name);</pre>
489
537
<p>
490
538
Construct the UI component with name <em class="parameter"><code>name</code></em></p>
491
 
<p>
492
 
</p>
493
539
<div class="variablelist"><table border="0">
494
540
<col align="left" valign="top">
495
541
<tbody>
514
560
<hr>
515
561
<div class="refsect2" title="bonobo_ui_component_new ()">
516
562
<a name="bonobo-ui-component-new"></a><h3>bonobo_ui_component_new ()</h3>
517
 
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * bonobo_ui_component_new             (const char *name);</pre>
 
563
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * bonobo_ui_component_new             (const <span class="returnvalue">char</span> *name);</pre>
518
564
<p>
519
565
Create a new UI component with the specified name</p>
520
 
<p>
521
 
</p>
522
566
<div class="variablelist"><table border="0">
523
567
<col align="left" valign="top">
524
568
<tbody>
538
582
<hr>
539
583
<div class="refsect2" title="bonobo_ui_component_new_default ()">
540
584
<a name="bonobo-ui-component-new-default"></a><h3>bonobo_ui_component_new_default ()</h3>
541
 
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> * bonobo_ui_component_new_default     (void);</pre>
 
585
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> * bonobo_ui_component_new_default     (void);</pre>
542
586
<p>
543
587
Create a UI component with a unique default name
544
588
constructed from various available system properties.</p>
545
 
<p>
546
 
</p>
547
589
<div class="variablelist"><table border="0">
548
590
<col align="left" valign="top">
549
591
<tbody><tr>
556
598
<hr>
557
599
<div class="refsect2" title="bonobo_ui_component_set_name ()">
558
600
<a name="bonobo-ui-component-set-name"></a><h3>bonobo_ui_component_set_name ()</h3>
559
 
<pre class="programlisting">void                bonobo_ui_component_set_name        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
560
 
                                                         const char *name);</pre>
 
601
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_name        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
602
                                                         const <span class="returnvalue">char</span> *name);</pre>
561
603
<p>
562
604
Set the <em class="parameter"><code>name</code></em> of the UI <em class="parameter"><code>component</code></em></p>
563
 
<p>
564
 
</p>
565
605
<div class="variablelist"><table border="0">
566
606
<col align="left" valign="top">
567
607
<tbody>
581
621
<hr>
582
622
<div class="refsect2" title="bonobo_ui_component_get_name ()">
583
623
<a name="bonobo-ui-component-get-name"></a><h3>bonobo_ui_component_get_name ()</h3>
584
 
<pre class="programlisting">const char *        bonobo_ui_component_get_name        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component);</pre>
585
 
<p>
586
 
</p>
587
 
<p>
588
 
</p>
 
624
<pre class="programlisting">const <span class="returnvalue">char</span> *        bonobo_ui_component_get_name        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component);</pre>
589
625
<div class="variablelist"><table border="0">
590
626
<col align="left" valign="top">
591
627
<tbody>
605
641
<hr>
606
642
<div class="refsect2" title="bonobo_ui_component_set_container ()">
607
643
<a name="bonobo-ui-component-set-container"></a><h3>bonobo_ui_component_set_container ()</h3>
608
 
<pre class="programlisting">void                bonobo_ui_component_set_container   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
609
 
                                                         Bonobo_UIContainer container,
610
 
                                                         CORBA_Environment *opt_ev);</pre>
 
644
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_container   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
645
                                                         <span class="returnvalue">Bonobo_UIContainer</span> container,
 
646
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
611
647
<p>
612
648
This associates this <em class="parameter"><code>component</code></em> with a remote <em class="parameter"><code>container</code></em>
613
649
object.</p>
614
 
<p>
615
 
</p>
616
650
<div class="variablelist"><table border="0">
617
651
<col align="left" valign="top">
618
652
<tbody>
637
671
<hr>
638
672
<div class="refsect2" title="bonobo_ui_component_unset_container ()">
639
673
<a name="bonobo-ui-component-unset-container"></a><h3>bonobo_ui_component_unset_container ()</h3>
640
 
<pre class="programlisting">void                bonobo_ui_component_unset_container (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
641
 
                                                         CORBA_Environment *opt_ev);</pre>
 
674
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_unset_container (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
675
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
642
676
<p>
643
677
This dis-associates the <em class="parameter"><code>component</code></em> from its associated
644
678
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>.</p>
645
 
<p>
646
 
</p>
647
679
<div class="variablelist"><table border="0">
648
680
<col align="left" valign="top">
649
681
<tbody>
663
695
<hr>
664
696
<div class="refsect2" title="bonobo_ui_component_get_container ()">
665
697
<a name="bonobo-ui-component-get-container"></a><h3>bonobo_ui_component_get_container ()</h3>
666
 
<pre class="programlisting">Bonobo_UIContainer  bonobo_ui_component_get_container   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component);</pre>
667
 
<p>
668
 
</p>
669
 
<p>
670
 
</p>
 
698
<pre class="programlisting"><span class="returnvalue">Bonobo_UIContainer</span>  bonobo_ui_component_get_container   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component);</pre>
671
699
<div class="variablelist"><table border="0">
672
700
<col align="left" valign="top">
673
701
<tbody>
687
715
<hr>
688
716
<div class="refsect2" title="bonobo_ui_component_add_verb ()">
689
717
<a name="bonobo-ui-component-add-verb"></a><h3>bonobo_ui_component_add_verb ()</h3>
690
 
<pre class="programlisting">void                bonobo_ui_component_add_verb        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
691
 
                                                         const char *cname,
692
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()">BonoboUIVerbFn</a> fn,
693
 
                                                         <a
694
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
695
 
>gpointer</a> user_data);</pre>
 
718
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_verb        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
719
                                                         const <span class="returnvalue">char</span> *cname,
 
720
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerbFn" title="BonoboUIVerbFn ()"><span class="returnvalue">BonoboUIVerbFn</span></a> fn,
 
721
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
696
722
<p>
697
723
Add a verb to the UI component, that can be invoked by
698
724
the container.</p>
699
 
<p>
700
 
</p>
701
725
<div class="variablelist"><table border="0">
702
726
<col align="left" valign="top">
703
727
<tbody>
727
751
<hr>
728
752
<div class="refsect2" title="bonobo_ui_component_add_verb_full ()">
729
753
<a name="bonobo-ui-component-add-verb-full"></a><h3>bonobo_ui_component_add_verb_full ()</h3>
730
 
<pre class="programlisting">void                bonobo_ui_component_add_verb_full   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
731
 
                                                         const char *cname,
732
 
                                                         <a
733
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
734
 
>GClosure</a> *closure);</pre>
 
754
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_verb_full   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
755
                                                         const <span class="returnvalue">char</span> *cname,
 
756
                                                         <span class="returnvalue">GClosure</span> *closure);</pre>
735
757
<p>
736
758
Add a verb to the UI component, that can be invoked by
737
759
the container.</p>
738
 
<p>
739
 
</p>
740
760
<div class="variablelist"><table border="0">
741
761
<col align="left" valign="top">
742
762
<tbody>
761
781
<hr>
762
782
<div class="refsect2" title="bonobo_ui_component_remove_verb ()">
763
783
<a name="bonobo-ui-component-remove-verb"></a><h3>bonobo_ui_component_remove_verb ()</h3>
764
 
<pre class="programlisting">void                bonobo_ui_component_remove_verb     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
765
 
                                                         const char *cname);</pre>
 
784
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_remove_verb     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
785
                                                         const <span class="returnvalue">char</span> *cname);</pre>
766
786
<p>
767
787
Remove a verb by it's unique name</p>
768
 
<p>
769
 
</p>
770
788
<div class="variablelist"><table border="0">
771
789
<col align="left" valign="top">
772
790
<tbody>
786
804
<hr>
787
805
<div class="refsect2" title="bonobo_ui_component_remove_verb_by_closure ()">
788
806
<a name="bonobo-ui-component-remove-verb-by-closure"></a><h3>bonobo_ui_component_remove_verb_by_closure ()</h3>
789
 
<pre class="programlisting">void                bonobo_ui_component_remove_verb_by_closure
790
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
791
 
                                                         <a
792
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
793
 
>GClosure</a> *closure);</pre>
 
807
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_remove_verb_by_closure
 
808
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
809
                                                         <span class="returnvalue">GClosure</span> *closure);</pre>
794
810
<p>
795
811
remove any verb handled by <em class="parameter"><code>fn</code></em>.</p>
796
 
<p>
797
 
</p>
798
812
<div class="variablelist"><table border="0">
799
813
<col align="left" valign="top">
800
814
<tbody>
814
828
<hr>
815
829
<div class="refsect2" title="bonobo_ui_component_add_listener ()">
816
830
<a name="bonobo-ui-component-add-listener"></a><h3>bonobo_ui_component_add_listener ()</h3>
817
 
<pre class="programlisting">void                bonobo_ui_component_add_listener    (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
818
 
                                                         const char *id,
819
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()">BonoboUIListenerFn</a> fn,
820
 
                                                         <a
821
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
822
 
>gpointer</a> user_data);</pre>
 
831
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_listener    (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
832
                                                         const <span class="returnvalue">char</span> *id,
 
833
                                                         <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIListenerFn" title="BonoboUIListenerFn ()"><span class="returnvalue">BonoboUIListenerFn</span></a> fn,
 
834
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
823
835
<p>
824
836
Add a listener for stateful events.</p>
825
 
<p>
826
 
</p>
827
837
<div class="variablelist"><table border="0">
828
838
<col align="left" valign="top">
829
839
<tbody>
853
863
<hr>
854
864
<div class="refsect2" title="bonobo_ui_component_add_listener_full ()">
855
865
<a name="bonobo-ui-component-add-listener-full"></a><h3>bonobo_ui_component_add_listener_full ()</h3>
856
 
<pre class="programlisting">void                bonobo_ui_component_add_listener_full
857
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
858
 
                                                         const char *id,
859
 
                                                         <a
860
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
861
 
>GClosure</a> *closure);</pre>
 
866
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_listener_full
 
867
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
868
                                                         const <span class="returnvalue">char</span> *id,
 
869
                                                         <span class="returnvalue">GClosure</span> *closure);</pre>
862
870
<p>
863
871
Add a listener for stateful events.</p>
864
 
<p>
865
 
</p>
866
872
<div class="variablelist"><table border="0">
867
873
<col align="left" valign="top">
868
874
<tbody>
887
893
<hr>
888
894
<div class="refsect2" title="bonobo_ui_component_remove_listener ()">
889
895
<a name="bonobo-ui-component-remove-listener"></a><h3>bonobo_ui_component_remove_listener ()</h3>
890
 
<pre class="programlisting">void                bonobo_ui_component_remove_listener (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
891
 
                                                         const char *cname);</pre>
 
896
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_remove_listener (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
897
                                                         const <span class="returnvalue">char</span> *cname);</pre>
892
898
<p>
893
899
Remove any listener by its unique id</p>
894
 
<p>
895
 
</p>
896
900
<div class="variablelist"><table border="0">
897
901
<col align="left" valign="top">
898
902
<tbody>
912
916
<hr>
913
917
<div class="refsect2" title="bonobo_ui_component_remove_listener_by_closure ()">
914
918
<a name="bonobo-ui-component-remove-listener-by-closure"></a><h3>bonobo_ui_component_remove_listener_by_closure ()</h3>
915
 
<pre class="programlisting">void                bonobo_ui_component_remove_listener_by_closure
916
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
917
 
                                                         <a
918
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
919
 
>GClosure</a> *closure);</pre>
 
919
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_remove_listener_by_closure
 
920
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
921
                                                         <span class="returnvalue">GClosure</span> *closure);</pre>
920
922
<p>
921
923
</p>
922
924
<div class="variablelist"><table border="0">
938
940
<hr>
939
941
<div class="refsect2" title="bonobo_ui_component_set ()">
940
942
<a name="bonobo-ui-component-set"></a><h3>bonobo_ui_component_set ()</h3>
941
 
<pre class="programlisting">void                bonobo_ui_component_set             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
942
 
                                                         const char *path,
943
 
                                                         const char *xml,
944
 
                                                         CORBA_Environment *opt_ev);</pre>
 
943
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
944
                                                         const <span class="returnvalue">char</span> *path,
 
945
                                                         const <span class="returnvalue">char</span> *xml,
 
946
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
945
947
<p>
946
948
Set the <em class="parameter"><code>xml</code></em> fragment into the remote <a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>'s tree
947
949
attached to <em class="parameter"><code>component</code></em> at the specified <em class="parameter"><code>path</code></em>
950
952
If you see blank menu items ( or just separators ) it's
951
953
likely that you should be using <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-set-translate" title="bonobo_ui_component_set_translate ()"><span class="type">bonobo_ui_component_set_translate</span></a>
952
954
which substantialy deprecates this routine.</p>
953
 
<p>
954
 
</p>
955
955
<div class="variablelist"><table border="0">
956
956
<col align="left" valign="top">
957
957
<tbody>
981
981
<hr>
982
982
<div class="refsect2" title="bonobo_ui_component_set_translate ()">
983
983
<a name="bonobo-ui-component-set-translate"></a><h3>bonobo_ui_component_set_translate ()</h3>
984
 
<pre class="programlisting">void                bonobo_ui_component_set_translate   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
985
 
                                                         const char *path,
986
 
                                                         const char *xml,
987
 
                                                         CORBA_Environment *opt_ev);</pre>
 
984
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_translate   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
985
                                                         const <span class="returnvalue">char</span> *path,
 
986
                                                         const <span class="returnvalue">char</span> *xml,
 
987
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
988
988
<p>
989
989
This routine parses the XML strings, and converts any:
990
990
_label="Hello World" type strings into the translated,
991
991
and encoded format expected by the remote <a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>.</p>
992
 
<p>
993
 
</p>
994
992
<div class="variablelist"><table border="0">
995
993
<col align="left" valign="top">
996
994
<tbody>
1020
1018
<hr>
1021
1019
<div class="refsect2" title="bonobo_ui_component_set_tree ()">
1022
1020
<a name="bonobo-ui-component-set-tree"></a><h3>bonobo_ui_component_set_tree ()</h3>
1023
 
<pre class="programlisting">void                bonobo_ui_component_set_tree        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1024
 
                                                         const char *path,
1025
 
                                                         <a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode">BonoboUINode</a> *node,
1026
 
                                                         CORBA_Environment *ev);</pre>
 
1021
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_tree        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1022
                                                         const <span class="returnvalue">char</span> *path,
 
1023
                                                         <a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode"><span class="returnvalue">BonoboUINode</span></a> *node,
 
1024
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);</pre>
1027
1025
<p>
1028
1026
Set the <em class="parameter"><code>xml</code></em> fragment into the remote <a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>'s tree
1029
1027
attached to <em class="parameter"><code>component</code></em> at the specified <em class="parameter"><code>path</code></em></p>
1030
 
<p>
1031
 
</p>
1032
1028
<div class="variablelist"><table border="0">
1033
1029
<col align="left" valign="top">
1034
1030
<tbody>
1058
1054
<hr>
1059
1055
<div class="refsect2" title="bonobo_ui_component_rm ()">
1060
1056
<a name="bonobo-ui-component-rm"></a><h3>bonobo_ui_component_rm ()</h3>
1061
 
<pre class="programlisting">void                bonobo_ui_component_rm              (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1062
 
                                                         const char *path,
1063
 
                                                         CORBA_Environment *ev);</pre>
 
1057
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_rm              (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1058
                                                         const <span class="returnvalue">char</span> *path,
 
1059
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);</pre>
1064
1060
<p>
1065
1061
This routine removes a chunk of the XML tree in the
1066
1062
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with <em class="parameter"><code>component</code></em> pointed
1067
1063
to by <em class="parameter"><code>path</code></em>.</p>
1068
 
<p>
1069
 
</p>
1070
1064
<div class="variablelist"><table border="0">
1071
1065
<col align="left" valign="top">
1072
1066
<tbody>
1091
1085
<hr>
1092
1086
<div class="refsect2" title="bonobo_ui_component_path_exists ()">
1093
1087
<a name="bonobo-ui-component-path-exists"></a><h3>bonobo_ui_component_path_exists ()</h3>
1094
 
<pre class="programlisting"><a
1095
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1096
 
>gboolean</a>            bonobo_ui_component_path_exists     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1097
 
                                                         const char *path,
1098
 
                                                         CORBA_Environment *ev);</pre>
1099
 
<p>
1100
 
</p>
1101
 
<p>
1102
 
</p>
 
1088
<pre class="programlisting"><span class="returnvalue">gboolean</span>            bonobo_ui_component_path_exists     (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1089
                                                         const <span class="returnvalue">char</span> *path,
 
1090
                                                         <span class="returnvalue">CORBA_Environment</span> *ev);</pre>
1103
1091
<div class="variablelist"><table border="0">
1104
1092
<col align="left" valign="top">
1105
1093
<tbody>
1129
1117
<hr>
1130
1118
<div class="refsect2" title="bonobo_ui_component_get ()">
1131
1119
<a name="bonobo-ui-component-get"></a><h3>bonobo_ui_component_get ()</h3>
1132
 
<pre class="programlisting">CORBA_char *        bonobo_ui_component_get             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1133
 
                                                         const char *path,
1134
 
                                                         <a
1135
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1136
 
>gboolean</a> recurse,
1137
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1120
<pre class="programlisting"><span class="returnvalue">CORBA_char</span> *        bonobo_ui_component_get             (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1121
                                                         const <span class="returnvalue">char</span> *path,
 
1122
                                                         <span class="returnvalue">gboolean</span> recurse,
 
1123
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1138
1124
<p>
1139
1125
This routine fetches a chunk of the XML tree in the
1140
1126
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with <em class="parameter"><code>component</code></em> pointed
1141
1127
to by <em class="parameter"><code>path</code></em>. If <em class="parameter"><code>recurse</code></em> then the child nodes of <em class="parameter"><code>path</code></em>
1142
1128
are returned too, otherwise they are not.</p>
1143
 
<p>
1144
 
</p>
1145
1129
<div class="variablelist"><table border="0">
1146
1130
<col align="left" valign="top">
1147
1131
<tbody>
1176
1160
<hr>
1177
1161
<div class="refsect2" title="bonobo_ui_component_get_tree ()">
1178
1162
<a name="bonobo-ui-component-get-tree"></a><h3>bonobo_ui_component_get_tree ()</h3>
1179
 
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode">BonoboUINode</a> *      bonobo_ui_component_get_tree        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1180
 
                                                         const char *path,
1181
 
                                                         <a
1182
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1183
 
>gboolean</a> recurse,
1184
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1163
<pre class="programlisting"><a class="link" href="libbonoboui-bonobo-ui-node.html#BonoboUINode" title="BonoboUINode"><span class="returnvalue">BonoboUINode</span></a> *      bonobo_ui_component_get_tree        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1164
                                                         const <span class="returnvalue">char</span> *path,
 
1165
                                                         <span class="returnvalue">gboolean</span> recurse,
 
1166
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1185
1167
<p>
1186
1168
This routine fetches a chunk of the XML tree in the
1187
1169
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with <em class="parameter"><code>component</code></em> pointed
1188
1170
to by <em class="parameter"><code>path</code></em>. If <em class="parameter"><code>recurse</code></em> then the child nodes of <em class="parameter"><code>path</code></em>
1189
1171
are returned too, otherwise they are not.</p>
1190
 
<p>
1191
 
</p>
1192
1172
<div class="variablelist"><table border="0">
1193
1173
<col align="left" valign="top">
1194
1174
<tbody>
1223
1203
<hr>
1224
1204
<div class="refsect2" title="bonobo_ui_component_object_set ()">
1225
1205
<a name="bonobo-ui-component-object-set"></a><h3>bonobo_ui_component_object_set ()</h3>
1226
 
<pre class="programlisting">void                bonobo_ui_component_object_set      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1227
 
                                                         const char *path,
1228
 
                                                         Bonobo_Unknown control,
1229
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1206
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_object_set      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1207
                                                         const <span class="returnvalue">char</span> *path,
 
1208
                                                         <span class="returnvalue">Bonobo_Unknown</span> control,
 
1209
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1230
1210
<p>
1231
1211
This registers the <em class="parameter"><code>control</code></em> CORBA object into the
1232
1212
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with this <em class="parameter"><code>component</code></em> at
1233
1213
the specified <em class="parameter"><code>path</code></em>. This is most often used to associate
1234
1214
controls with a certain path.</p>
1235
 
<p>
1236
 
</p>
1237
1215
<div class="variablelist"><table border="0">
1238
1216
<col align="left" valign="top">
1239
1217
<tbody>
1263
1241
<hr>
1264
1242
<div class="refsect2" title="bonobo_ui_component_object_get ()">
1265
1243
<a name="bonobo-ui-component-object-get"></a><h3>bonobo_ui_component_object_get ()</h3>
1266
 
<pre class="programlisting">Bonobo_Unknown      bonobo_ui_component_object_get      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1267
 
                                                         const char *path,
1268
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1244
<pre class="programlisting"><span class="returnvalue">Bonobo_Unknown</span>      bonobo_ui_component_object_get      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1245
                                                         const <span class="returnvalue">char</span> *path,
 
1246
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1269
1247
<p>
1270
1248
This returns the <em class="parameter"><code>control</code></em> CORBA object registered with the
1271
1249
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with this <em class="parameter"><code>component</code></em> at
1272
1250
the specified <em class="parameter"><code>path</code></em>.</p>
1273
 
<p>
1274
 
</p>
1275
1251
<div class="variablelist"><table border="0">
1276
1252
<col align="left" valign="top">
1277
1253
<tbody>
1301
1277
<hr>
1302
1278
<div class="refsect2" title="bonobo_ui_component_widget_set ()">
1303
1279
<a name="bonobo-ui-component-widget-set"></a><h3>bonobo_ui_component_widget_set ()</h3>
1304
 
<pre class="programlisting">void                bonobo_ui_component_widget_set      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1305
 
                                                         const char *path,
1306
 
                                                         <a
1307
 
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
1308
 
>GtkWidget</a> *widget,
1309
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1280
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_widget_set      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1281
                                                         const <span class="returnvalue">char</span> *path,
 
1282
                                                         <span class="returnvalue">GtkWidget</span> *widget,
 
1283
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1310
1284
<p>
1311
1285
</p>
1312
1286
<div class="variablelist"><table border="0">
1338
1312
<hr>
1339
1313
<div class="refsect2" title="bonobo_ui_component_freeze ()">
1340
1314
<a name="bonobo-ui-component-freeze"></a><h3>bonobo_ui_component_freeze ()</h3>
1341
 
<pre class="programlisting">void                bonobo_ui_component_freeze          (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1342
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1315
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_freeze          (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1316
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1343
1317
<p>
1344
1318
This increments the freeze count on the associated
1345
1319
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>, (if not already frozen) this means that
1349
1323
<p>
1350
1324
NB. if your GUI is frozen / not updating you probably have a
1351
1325
freeze / thaw reference leak/</p>
1352
 
<p>
1353
 
</p>
1354
1326
<div class="variablelist"><table border="0">
1355
1327
<col align="left" valign="top">
1356
1328
<tbody>
1370
1342
<hr>
1371
1343
<div class="refsect2" title="bonobo_ui_component_thaw ()">
1372
1344
<a name="bonobo-ui-component-thaw"></a><h3>bonobo_ui_component_thaw ()</h3>
1373
 
<pre class="programlisting">void                bonobo_ui_component_thaw            (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1374
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1345
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_thaw            (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1346
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1375
1347
<p>
1376
1348
This decrements the freeze count on the remote associated
1377
1349
<a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>, (if frozen). This means that a batch
1381
1353
<p>
1382
1354
NB. if your GUI is frozen / not updating you probably have a
1383
1355
freeze / thaw reference leak/</p>
1384
 
<p>
1385
 
</p>
1386
1356
<div class="variablelist"><table border="0">
1387
1357
<col align="left" valign="top">
1388
1358
<tbody>
1402
1372
<hr>
1403
1373
<div class="refsect2" title="bonobo_ui_component_set_prop ()">
1404
1374
<a name="bonobo-ui-component-set-prop"></a><h3>bonobo_ui_component_set_prop ()</h3>
1405
 
<pre class="programlisting">void                bonobo_ui_component_set_prop        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1406
 
                                                         const char *path,
1407
 
                                                         const char *prop,
1408
 
                                                         const char *value,
1409
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1375
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_prop        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1376
                                                         const <span class="returnvalue">char</span> *path,
 
1377
                                                         const <span class="returnvalue">char</span> *prop,
 
1378
                                                         const <span class="returnvalue">char</span> *value,
 
1379
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1410
1380
<p>
1411
1381
This helper function sets an XML property ( or attribute )
1412
1382
on the XML node pointed at by <em class="parameter"><code>path</code></em>. It does this by
1413
1383
a read / modify / write process. If you find yourself
1414
1384
doing this a lot, you need to consider batching this process.</p>
1415
 
<p>
1416
 
</p>
1417
1385
<div class="variablelist"><table border="0">
1418
1386
<col align="left" valign="top">
1419
1387
<tbody>
1448
1416
<hr>
1449
1417
<div class="refsect2" title="bonobo_ui_component_get_prop ()">
1450
1418
<a name="bonobo-ui-component-get-prop"></a><h3>bonobo_ui_component_get_prop ()</h3>
1451
 
<pre class="programlisting"><a
1452
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1453
 
>gchar</a> *             bonobo_ui_component_get_prop        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1454
 
                                                         const char *path,
1455
 
                                                         const char *prop,
1456
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1419
<pre class="programlisting"><span class="returnvalue">gchar</span> *             bonobo_ui_component_get_prop        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1420
                                                         const <span class="returnvalue">char</span> *path,
 
1421
                                                         const <span class="returnvalue">char</span> *prop,
 
1422
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1457
1423
<p>
1458
1424
This helper function fetches an XML property ( or attribute )
1459
1425
from the XML node pointed at by <em class="parameter"><code>path</code></em> in the <a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>
1460
1426
associated with <em class="parameter"><code>component</code></em></p>
1461
 
<p>
1462
 
</p>
1463
1427
<div class="variablelist"><table border="0">
1464
1428
<col align="left" valign="top">
1465
1429
<tbody>
1494
1458
<hr>
1495
1459
<div class="refsect2" title="bonobo_ui_component_set_status ()">
1496
1460
<a name="bonobo-ui-component-set-status"></a><h3>bonobo_ui_component_set_status ()</h3>
1497
 
<pre class="programlisting">void                bonobo_ui_component_set_status      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1498
 
                                                         const char *text,
1499
 
                                                         CORBA_Environment *opt_ev);</pre>
 
1461
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_set_status      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1462
                                                         const <span class="returnvalue">char</span> *text,
 
1463
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
1500
1464
<p>
1501
1465
This sets the contents of the status bar to <em class="parameter"><code>text</code></em> in the
1502
1466
remote <a class="link" href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a> associated with <em class="parameter"><code>component</code></em>.
1503
1467
This is done by setting the contents of the /status/main
1504
1468
node.</p>
1505
 
<p>
1506
 
</p>
1507
1469
<div class="variablelist"><table border="0">
1508
1470
<col align="left" valign="top">
1509
1471
<tbody>
1540
1502
</div>
1541
1503
<hr>
1542
1504
<div class="refsect2" title="BONOBO_UI_VERB()">
1543
 
<a name="BONOBO-UI-VERB--CAPS"></a><h3>BONOBO_UI_VERB()</h3>
 
1505
<a name="BONOBO-UI-VERB:CAPS"></a><h3>BONOBO_UI_VERB()</h3>
1544
1506
<pre class="programlisting">#define BONOBO_UI_VERB(name,cb)                  { (name), (cb), NULL   }
1545
1507
</pre>
1546
1508
<p>
1566
1528
</div>
1567
1529
<hr>
1568
1530
<div class="refsect2" title="BONOBO_UI_VERB_DATA()">
1569
 
<a name="BONOBO-UI-VERB-DATA--CAPS"></a><h3>BONOBO_UI_VERB_DATA()</h3>
 
1531
<a name="BONOBO-UI-VERB-DATA:CAPS"></a><h3>BONOBO_UI_VERB_DATA()</h3>
1570
1532
<pre class="programlisting">#define BONOBO_UI_VERB_DATA(name,cb,data)        { (name), (cb), (data) }
1571
1533
</pre>
1572
1534
<p>
1597
1559
</div>
1598
1560
<hr>
1599
1561
<div class="refsect2" title="BONOBO_UI_UNSAFE_VERB()">
1600
 
<a name="BONOBO-UI-UNSAFE-VERB--CAPS"></a><h3>BONOBO_UI_UNSAFE_VERB()</h3>
 
1562
<a name="BONOBO-UI-UNSAFE-VERB:CAPS"></a><h3>BONOBO_UI_UNSAFE_VERB()</h3>
1601
1563
<pre class="programlisting">#define BONOBO_UI_UNSAFE_VERB(name,cb)           { (name), ((BonoboUIVerbFn)(cb)), NULL   }
1602
1564
</pre>
1603
1565
<p>
1621
1583
</div>
1622
1584
<hr>
1623
1585
<div class="refsect2" title="BONOBO_UI_UNSAFE_VERB_DATA()">
1624
 
<a name="BONOBO-UI-UNSAFE-VERB-DATA--CAPS"></a><h3>BONOBO_UI_UNSAFE_VERB_DATA()</h3>
 
1586
<a name="BONOBO-UI-UNSAFE-VERB-DATA:CAPS"></a><h3>BONOBO_UI_UNSAFE_VERB_DATA()</h3>
1625
1587
<pre class="programlisting">#define BONOBO_UI_UNSAFE_VERB_DATA(name,cb,data) { (name), ((BonoboUIVerbFn)(cb)), (data) }
1626
1588
</pre>
1627
1589
<p>
1650
1612
</div>
1651
1613
<hr>
1652
1614
<div class="refsect2" title="BONOBO_UI_VERB_END">
1653
 
<a name="BONOBO-UI-VERB-END--CAPS"></a><h3>BONOBO_UI_VERB_END</h3>
 
1615
<a name="BONOBO-UI-VERB-END:CAPS"></a><h3>BONOBO_UI_VERB_END</h3>
1654
1616
<pre class="programlisting">#define BONOBO_UI_VERB_END                       { NULL, NULL, NULL }
1655
1617
</pre>
1656
1618
<p>
1660
1622
<hr>
1661
1623
<div class="refsect2" title="bonobo_ui_component_add_verb_list ()">
1662
1624
<a name="bonobo-ui-component-add-verb-list"></a><h3>bonobo_ui_component_add_verb_list ()</h3>
1663
 
<pre class="programlisting">void                bonobo_ui_component_add_verb_list   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1664
 
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb">BonoboUIVerb</a> *list);</pre>
 
1625
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_verb_list   (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1626
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="returnvalue">BonoboUIVerb</span></a> *list);</pre>
1665
1627
<p>
1666
1628
Add a list of verbs with no associated user_data, you probably
1667
1629
want <a class="link" href="libbonoboui-bonobo-ui-component.html#bonobo-ui-component-add-verb-list-with-data" title="bonobo_ui_component_add_verb_list_with_data ()"><span class="type">bonobo_ui_component_add_verb_list_with_data</span></a></p>
1668
 
<p>
1669
 
</p>
1670
1630
<div class="variablelist"><table border="0">
1671
1631
<col align="left" valign="top">
1672
1632
<tbody>
1686
1646
<hr>
1687
1647
<div class="refsect2" title="bonobo_ui_component_add_verb_list_with_data ()">
1688
1648
<a name="bonobo-ui-component-add-verb-list-with-data"></a><h3>bonobo_ui_component_add_verb_list_with_data ()</h3>
1689
 
<pre class="programlisting">void                bonobo_ui_component_add_verb_list_with_data
1690
 
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *component,
1691
 
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb">BonoboUIVerb</a> *list,
1692
 
                                                         <a
1693
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1694
 
>gpointer</a> user_data);</pre>
 
1649
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_ui_component_add_verb_list_with_data
 
1650
                                                        (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="returnvalue">BonoboUIComponent</span></a> *component,
 
1651
                                                         const <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="returnvalue">BonoboUIVerb</span></a> *list,
 
1652
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
1695
1653
<p>
1696
1654
This is a helper function to save registering verbs individualy
1697
1655
it allows registration of a great batch of verbs at one time
1698
 
in a list of <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="type">BonoboUIVerb</span></a> terminated by <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-END--CAPS" title="BONOBO_UI_VERB_END"><span class="type">BONOBO_UI_VERB_END</span></a></p>
1699
 
<p>
1700
 
</p>
 
1656
in a list of <a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIVerb" title="BonoboUIVerb"><span class="type">BonoboUIVerb</span></a> terminated by <a class="link" href="libbonoboui-bonobo-ui-component.html#BONOBO-UI-VERB-END:CAPS" title="BONOBO_UI_VERB_END"><span class="type">BONOBO_UI_VERB_END</span></a></p>
1701
1657
<div class="variablelist"><table border="0">
1702
1658
<col align="left" valign="top">
1703
1659
<tbody>
1724
1680
<a name="libbonoboui-bonobo-ui-component.signal-details"></a><h2>Signal Details</h2>
1725
1681
<div class="refsect2" title='The "exec-verb" signal'>
1726
1682
<a name="BonoboUIComponent-exec-verb"></a><h3>The <code class="literal">"exec-verb"</code> signal</h3>
1727
 
<pre class="programlisting">void                user_function                      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *bonobouicomponent,
1728
 
                                                        <a
1729
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1730
 
>gchar</a>             *arg1,
1731
 
                                                        <a
1732
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1733
 
>gpointer</a>           user_data)              : Run First</pre>
 
1683
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="type">BonoboUIComponent</span></a> *bonobouicomponent,
 
1684
                                                        <span class="type">gchar</span>             *arg1,
 
1685
                                                        <span class="type">gpointer</span>           user_data)              : Run First</pre>
1734
1686
<p>
1735
1687
</p>
1736
1688
<div class="variablelist"><table border="0">
1756
1708
<hr>
1757
1709
<div class="refsect2" title='The "ui-event" signal'>
1758
1710
<a name="BonoboUIComponent-ui-event"></a><h3>The <code class="literal">"ui-event"</code> signal</h3>
1759
 
<pre class="programlisting">void                user_function                      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent">BonoboUIComponent</a> *bonobouicomponent,
1760
 
                                                        <a
1761
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1762
 
>gchar</a>             *arg1,
1763
 
                                                        <a
1764
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
1765
 
>gint</a>               arg2,
1766
 
                                                        <a
1767
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
1768
 
>gchar</a>             *arg3,
1769
 
                                                        <a
1770
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1771
 
>gpointer</a>           user_data)              : Run First</pre>
 
1711
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="type">BonoboUIComponent</span></a> *bonobouicomponent,
 
1712
                                                        <span class="type">gchar</span>             *arg1,
 
1713
                                                        <span class="type">gint</span>               arg2,
 
1714
                                                        <span class="type">gchar</span>             *arg3,
 
1715
                                                        <span class="type">gpointer</span>           user_data)              : Run First</pre>
1772
1716
<p>
1773
1717
</p>
1774
1718
<div class="variablelist"><table border="0">
1811
1755
</div>
1812
1756
<div class="footer">
1813
1757
<hr>
1814
 
          Generated by GTK-Doc V1.11</div>
 
1758
          Generated by GTK-Doc V1.14</div>
1815
1759
</body>
1816
 
</html>
 
1760
</html>
 
 
b'\\ No newline at end of file'