|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21585/root/usr/share/gtk-doc/html/libbonoboui/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>BonoboWidget</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="LibBonoboUI API Reference Manual">
<link rel="up" href="bonobo-ui.html" title="Bonobo UI">
<link rel="prev" href="bonobo-ui.html" title="Bonobo UI">
<link rel="next" href="libbonoboui-bonobo-window.html" title="bonobo-window">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="bonobo-controls.html" title="Controls">
<link rel="chapter" href="bonobo-ui.html" title="Bonobo UI">
<link rel="chapter" href="bonobo-support-utilities.html" title="Supporting Classes">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="bonobo-ui.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="bonobo-ui.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">LibBonoboUI API Reference Manual</th>
<td><a accesskey="n" href="libbonoboui-bonobo-window.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2764281" class="shortcut">Top</a>
 | 
<a href="#id2764798" class="shortcut">Description</a>
 | 
<a href="#id2764713" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id2764775" class="shortcut">Implemented Interfaces</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libbonoboui-bonobo-widget"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2764281"></a><span class="refentrytitle">BonoboWidget</span>
</h2>
<p>BonoboWidget — Simplified embedding of widgets in Bonobo.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<a name="BonoboWidget"></a><pre class="synopsis">
<a href="libbonoboui-bonobo-widget.html#BonoboWidget-struct">BonoboWidget</a>;
<a href="libbonoboui-bonobo-widget.html#BonoboWidgetPrivate">BonoboWidgetPrivate</a>;
<a href="libbonoboui-bonobo-widget.html#BonoboWidgetClass">BonoboWidgetClass</a>;
Bonobo_Unknown <a href="libbonoboui-bonobo-widget.html#bonobo-widget-get-objref">bonobo_widget_get_objref</a> (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control">bonobo_widget_new_control</a> (const char *moniker,
Bonobo_UIContainer uic);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control-from-objref">bonobo_widget_new_control_from_objref</a>
(Bonobo_Control control,
Bonobo_UIContainer uic);
<a href="libbonoboui-bonobo-control-frame.html#BonoboControlFrame">BonoboControlFrame</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-get-control-frame">bonobo_widget_get_control_frame</a>
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);
Bonobo_UIContainer <a href="libbonoboui-bonobo-widget.html#bonobo-widget-get-ui-container">bonobo_widget_get_ui_container</a>
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);
void (<a href="libbonoboui-bonobo-widget.html#BonoboWidgetAsyncFn">*BonoboWidgetAsyncFn</a>) (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *widget,
CORBA_Environment *ev,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control-async">bonobo_widget_new_control_async</a> (const char *moniker,
Bonobo_UIContainer uic,
<a href="libbonoboui-bonobo-widget.html#BonoboWidgetAsyncFn">BonoboWidgetAsyncFn</a> fn,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-construct-control-from-objref">bonobo_widget_construct_control_from_objref</a>
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw,
Bonobo_Control control,
Bonobo_UIContainer uic,
CORBA_Environment *ev);
<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a>* <a href="libbonoboui-bonobo-widget.html#bonobo-widget-construct-control">bonobo_widget_construct_control</a>
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw,
const char *moniker,
Bonobo_UIContainer uic,
CORBA_Environment *ev);
void <a href="libbonoboui-bonobo-widget.html#bonobo-widget-set-property">bonobo_widget_set_property</a> (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *control,
const char *first_prop,
...);
void <a href="libbonoboui-bonobo-widget.html#bonobo-widget-get-property">bonobo_widget_get_property</a> (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *control,
const char *first_prop,
...);
#define <a href="libbonoboui-bonobo-widget.html#bonobo-widget-get-uih">bonobo_widget_get_uih</a> (w)
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2764713"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
>GtkObject</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
>GtkContainer</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
>GtkBin</a>
+----BonoboWidget
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2764775"></a><h2>Implemented Interfaces</h2>
<p>
BonoboWidget implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2764798"></a><h2>Description</h2>
<p>
Bonobo component embedding for hydrocephalic imbeciles.
</p>
<p>
Pure cane sugar.
</p>
<p>
This purpose of BonoboWidget is to make container-side use of Bonobo
as easy as pie. This widget has two functions:
</p>
<div class="orderedlist"><ol type="1">
<li>
<p>
Provide a simple wrapper for embedding Controls. Embedding
controls is already really easy, but BonoboWidget reduces the
work from about 5 lines to 1. To embed a given control, just
do:
</p>
<div class="informalexample"><pre class="programlisting">
bw = bonobo_widget_new_control ("id for control", toplevel_ui_handler);
gtk_container_add (some_container, bw);
</pre></div>
<p>
</p>
<p>
You are free to make the 2nd (UIContainer) argument to
<a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control"><code class="function">bonobo_widget_new_control()</code></a> be CORBA_OBJECT_NIL.
</p>
</li>
<li>
<p>
To provide an extremely simple wrapper for using Monikers. In
fact all BonoboWidget use uses the OAFIID: moniker to activate
its sub-components. However monikers (<span class="type">bonobo-moniker-util</span>) are
far more powerful than this:
</p>
<div class="informalexample"><pre class="programlisting">
bw = bonobo_widget_new_control ("file:/demo/a.jpeg", toplevel_ui_handler);
</pre></div>
<p>
will launch an application that can render a jpeg as a control,
usualy the Eye Of Gnome (EOG), and embed it as a control.
</p>
</li>
</ol></div>
<p>
</p>
<p>
There are also functions for fetching and setting values in the
Control PropertyBag, but the use of these functions is
discouraged.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2764907"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2764917"></a><h3>
<a name="BonoboWidget-struct"></a>BonoboWidget</h3>
<a class="indexterm" name="id2764930"></a><pre class="programlisting">typedef struct _BonoboWidget BonoboWidget;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2764945"></a><h3>
<a name="BonoboWidgetPrivate"></a>BonoboWidgetPrivate</h3>
<a class="indexterm" name="id2764958"></a><pre class="programlisting">typedef struct _BonoboWidgetPrivate BonoboWidgetPrivate;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2764973"></a><h3>
<a name="BonoboWidgetClass"></a>BonoboWidgetClass</h3>
<a class="indexterm" name="id2764986"></a><pre class="programlisting">typedef struct {
GtkBinClass bin_class;
gpointer dummy[4];
} BonoboWidgetClass;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765002"></a><h3>
<a name="bonobo-widget-get-objref"></a>bonobo_widget_get_objref ()</h3>
<a class="indexterm" name="id2765015"></a><pre class="programlisting">Bonobo_Unknown bonobo_widget_get_objref (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bw</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765072"></a><h3>
<a name="bonobo-widget-new-control"></a>bonobo_widget_new_control ()</h3>
<a class="indexterm" name="id2765085"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* bonobo_widget_new_control (const char *moniker,
Bonobo_UIContainer uic);</pre>
<p>
This function is a simple wrapper for easily embedding controls
into applications. It will launch the component identified by <em class="parameter"><code>id</code></em>
and will return it as a GtkWidget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> A Moniker describing the object to be activated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uic</code></em> :</span></td>
<td> Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL
if there is no need of menu / toolbar merging.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
><span class="type">GtkWidget</span></a> that is bound to the Bonobo Control.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765185"></a><h3>
<a name="bonobo-widget-new-control-from-objref"></a>bonobo_widget_new_control_from_objref ()</h3>
<a class="indexterm" name="id2765200"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* bonobo_widget_new_control_from_objref
(Bonobo_Control control,
Bonobo_UIContainer uic);</pre>
<p>
This function is a simple wrapper for easily embedding controls
into applications. This function is used when you have already
a CORBA object reference to an IDL:Bonobo/Control:1.0 (the
<em class="parameter"><code>control</code></em>) argument.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>control</code></em> :</span></td>
<td> A CORBA Object reference to an IDL:Bonobo/Control:1.0
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uic</code></em> :</span></td>
<td> Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL
if there is no need of menu / toolbar merging.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the <em class="parameter"><code>control</code></em> wrapped as a <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765308"></a><h3>
<a name="bonobo-widget-get-control-frame"></a>bonobo_widget_get_control_frame ()</h3>
<a class="indexterm" name="id2765321"></a><pre class="programlisting"><a href="libbonoboui-bonobo-control-frame.html#BonoboControlFrame">BonoboControlFrame</a>* bonobo_widget_get_control_frame
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);</pre>
<p>
Every IDL:Bonobo/Control:1.0 needs to be placed inside an
IDL:Bonobo/ControlFrame:1.0. This returns the BonoboControlFrame
object that wraps the Control in the <em class="parameter"><code>bonobo_widget</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bw</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The BonoboControlFrame associated with the <em class="parameter"><code>bonobo_widget</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765398"></a><h3>
<a name="bonobo-widget-get-ui-container"></a>bonobo_widget_get_ui_container ()</h3>
<a class="indexterm" name="id2765411"></a><pre class="programlisting">Bonobo_UIContainer bonobo_widget_get_ui_container
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bw</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the CORBA object reference to the Bonobo_UIContainer
associated with the <em class="parameter"><code>bonobo_widget</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765479"></a><h3>
<a name="BonoboWidgetAsyncFn"></a>BonoboWidgetAsyncFn ()</h3>
<a class="indexterm" name="id2765492"></a><pre class="programlisting">void (*BonoboWidgetAsyncFn) (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *widget,
CORBA_Environment *ev,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765580"></a><h3>
<a name="bonobo-widget-new-control-async"></a>bonobo_widget_new_control_async ()</h3>
<a class="indexterm" name="id2765594"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* bonobo_widget_new_control_async (const char *moniker,
Bonobo_UIContainer uic,
<a href="libbonoboui-bonobo-widget.html#BonoboWidgetAsyncFn">BonoboWidgetAsyncFn</a> fn,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<p>
This method creates a widget, returns it to the user, and
asynchronously activates a control to insert into the widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> A Moniker describing the object to be activated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uic</code></em> :</span></td>
<td> Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL
if there is no need of menu / toolbar merging.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>fn</code></em> :</span></td>
<td> a callback function called when the activation has happend
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> user data to be passed back to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a (temporarily) empty Widget to be filled with the
control later
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765725"></a><h3>
<a name="bonobo-widget-construct-control-from-objref"></a>bonobo_widget_construct_control_from_objref ()</h3>
<a class="indexterm" name="id2765740"></a><pre class="programlisting"><a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a>* bonobo_widget_construct_control_from_objref
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw,
Bonobo_Control control,
Bonobo_UIContainer uic,
CORBA_Environment *ev);</pre>
<p>
This is a constructor function. Only usable for wrapping and
derivation of new objects. For normal use, please refer to
<a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control-from-objref"><span class="type">bonobo_widget_new_control_from_objref</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bw</code></em> :</span></td>
<td> A BonoboWidget to construct
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>control</code></em> :</span></td>
<td> A CORBA Object reference to an IDL:Bonobo/Control:1.0
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uic</code></em> :</span></td>
<td> Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL
if there is no need of menu / toolbar merging.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td> a CORBA exception environment
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A <a href="libbonoboui-bonobo-widget.html#BonoboWidget"><span class="type">BonoboWidget</span></a> (the <em class="parameter"><code>bw</code></em>)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2765894"></a><h3>
<a name="bonobo-widget-construct-control"></a>bonobo_widget_construct_control ()</h3>
<a class="indexterm" name="id2765907"></a><pre class="programlisting"><a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a>* bonobo_widget_construct_control
(<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *bw,
const char *moniker,
Bonobo_UIContainer uic,
CORBA_Environment *ev);</pre>
<p>
This is a constructor function. Only usable for wrapping and
derivation of new objects. For normal use, please refer to
<a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control"><span class="type">bonobo_widget_new_control</span></a>.
</p>
<p>
This function will unref the passed in <em class="parameter"><code>bw</code></em> in case it cannot launch
the component and return <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> in such a case. Otherwise it returns
the <em class="parameter"><code>bw</code></em> itself.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>bw</code></em> :</span></td>
<td> A BonoboWidget to construct
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> A Moniker describing the object to be activated
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>uic</code></em> :</span></td>
<td> Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL
if there is no need of menu / toolbar merging.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ev</code></em> :</span></td>
<td> a CORBA exception environment
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A <a href="libbonoboui-bonobo-widget.html#BonoboWidget"><span class="type">BonoboWidget</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2766093"></a><h3>
<a name="bonobo-widget-set-property"></a>bonobo_widget_set_property ()</h3>
<a class="indexterm" name="id2766107"></a><pre class="programlisting">void bonobo_widget_set_property (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *control,
const char *first_prop,
...);</pre>
<p>
This is a utility function used to set a number of properties
in the Bonobo Control in <em class="parameter"><code>control</code></em>.
</p>
<p>
This function takes a variable list of arguments that must be NULL
terminated. Arguments come in tuples: a string (for the argument
name) and the data type that is to be transfered. The
implementation of the actual setting of the PropertyBag values is
done by the <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-property-bag-client.html#bonobo-property-bag-client-setv"
><code class="function">bonobo_property_bag_client_setv()</code></a> function).
</p>
<p>
This only works for BonoboWidgets that represent controls (ie,
that were returned by <a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control-from-objref"><code class="function">bonobo_widget_new_control_from_objref()</code></a> or
<a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control"><code class="function">bonobo_widget_new_control()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>control</code></em> :</span></td>
<td> A <a href="libbonoboui-bonobo-widget.html#BonoboWidget"><span class="type">BonoboWidget</span></a> that represents an IDL:Bonobo/Control:1.0
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_prop</code></em> :</span></td>
<td> first property name to set.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2766256"></a><h3>
<a name="bonobo-widget-get-property"></a>bonobo_widget_get_property ()</h3>
<a class="indexterm" name="id2766270"></a><pre class="programlisting">void bonobo_widget_get_property (<a href="libbonoboui-bonobo-widget.html#BonoboWidget">BonoboWidget</a> *control,
const char *first_prop,
...);</pre>
<p>
This is a utility function used to get a number of properties
in the Bonobo Control in <em class="parameter"><code>control</code></em>.
</p>
<p>
This function takes a variable list of arguments that must be NULL
terminated. Arguments come in tuples: a string (for the argument
name) and a pointer where the data will be stored. The
implementation of the actual setting of the PropertyBag values is
done by the <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-property-bag-client.html#bonobo-property-bag-client-setv"
><code class="function">bonobo_property_bag_client_setv()</code></a> function).
</p>
<p>
This only works for BonoboWidgets that represent controls (ie,
that were returned by <a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control-from-objref"><code class="function">bonobo_widget_new_control_from_objref()</code></a> or
<a href="libbonoboui-bonobo-widget.html#bonobo-widget-new-control"><code class="function">bonobo_widget_new_control()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>control</code></em> :</span></td>
<td> A <a href="libbonoboui-bonobo-widget.html#BonoboWidget"><span class="type">BonoboWidget</span></a> that represents an IDL:Bonobo/Control:1.0
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_prop</code></em> :</span></td>
<td> first property name to set.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2766418"></a><h3>
<a name="bonobo-widget-get-uih"></a>bonobo_widget_get_uih()</h3>
<a class="indexterm" name="id2766432"></a><pre class="programlisting">#define bonobo_widget_get_uih(w) bonobo_widget_get_ui_container (w)
</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>w</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2766477"></a><h2>See Also</h2>
<p>
Object activation happens with <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-moniker-util.html#bonobo-get-object"
><code class="function">bonobo_get_object()</code></a>.
</p>
<p>
<a href="libbonoboui-bonobo-control.html#BonoboControl"><span class="type">BonoboControl</span></a>, <a href="libbonoboui-bonobo-control-frame.html#BonoboControlFrame"><span class="type">BonoboControlFrame</span></a>, <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-object.html#BonoboObject"
><span class="type">BonoboObject</span></a>, <span class="type">BonoboView</span>,
<span class="type">BonoboEmbeddable</span>, <a href="libbonoboui-bonobo-ui-container.html#BonoboUIContainer"><span class="type">BonoboUIContainer</span></a>, <a
href="/usr/share/gtk-doc/html/libbonobo/libbonobo-bonobo-item-container.html#BonoboItemContainer"
><span class="type">BonoboItemContainer</span></a>.
</p>
</div>
</div>
</body>
</html>