File: //usr/local/ssl/share/gtk-doc/html/libbonobo/libbonobo-bonobo-running-context.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>BonoboRunningContext</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="Libbonobo Reference Manual">
<link rel="up" href="general.html" title="General">
<link rel="prev" href="libbonobo-bonobo-main.html" title="bonobo-main">
<link rel="next" href="libbonobo-bonobo-shutdown.html" title="bonobo-shutdown">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="general.html" title="General">
<link rel="chapter" href="factories.html" title="Objects, Factories, Reference Counting">
<link rel="chapter" href="property-bags.html" title="Property Bags, Events, Listeners">
<link rel="chapter" href="monikers.html" title="Monikers">
<link rel="chapter" href="streams.html" title="Storages and Streams">
<link rel="chapter" href="persist.html" title="Persistency">
<link rel="chapter" href="misc.html" title="Miscellaneous">
</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="libbonobo-bonobo-main.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="general.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">Libbonobo Reference Manual</th>
<td><a accesskey="n" href="libbonobo-bonobo-shutdown.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="#id2679209" class="shortcut">Top</a>
 | 
<a href="#id2679302" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libbonobo-bonobo-running-context"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2679209"></a><span class="refentrytitle">BonoboRunningContext</span>
</h2>
<p>BonoboRunningContext — a live object tracker</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
<a href="libbonobo-bonobo-running-context.html#BonoboRunningContext">BonoboRunningContext</a>;
<a href="libbonobo-bonobo-running-context.html#BonoboRunningContextClass">BonoboRunningContextClass</a>;
<a href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a>* <a href="libbonobo-bonobo-running-context.html#bonobo-running-context-new">bonobo_running_context_new</a> (void);
void <a href="libbonobo-bonobo-running-context.html#bonobo-running-context-ignore-object">bonobo_running_context_ignore_object</a>
(CORBA_Object object);
void <a href="libbonobo-bonobo-running-context.html#bonobo-running-context-at-exit-unref">bonobo_running_context_at_exit_unref</a>
(CORBA_Object object);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2679302"></a><h2>Description</h2>
<p>
<a href="libbonobo-bonobo-running-context.html#BonoboRunningContext"><span class="type">BonoboRunningContext</span></a> implements the
<code class="classname">Bonobo::RunningContext</code> IDL interface,
depicted in <a href="libbonobo-bonobo-running-context.html#running-context-img" title="Figure 1. The Bonobo::RunningContext interface">Figure 1, “The Bonobo::RunningContext interface”</a>.
</p>
<div class="figure">
<a name="running-context-img"></a><p class="title"><b>Figure 1. The Bonobo::RunningContext interface</b></p>
<div class="mediaobject"><img src="running-context.png" alt="The Bonobo::RunningContext interface"></div>
</div>
<p>
The purpose of this object is to keep track of currently running
objects. This is useful in, for example, exe type factories, in
order to know when it is safe to quit from the main loop.
</p>
<p>
<a href="libbonobo-bonobo-running-context.html#BonoboRunningContext"><span class="type">BonoboRunningContext</span></a> is a singleton. There is at most one
instance running at all times. All <a href="libbonobo-bonobo-object.html#BonoboObject"><span class="type">BonoboObject</span></a>'s are
automatically registered with the running context as part of their
normal initialization procedure.
</p>
<p>
To find out when all objects have been destroyed, just connect a
handler to the "last-unref" signal.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2679396"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2679407"></a><h3>
<a name="BonoboRunningContext"></a>BonoboRunningContext</h3>
<a class="indexterm" name="id2679419"></a><pre class="programlisting">typedef struct {
BonoboObject parent;
BonoboRunningContextPrivate *priv;
} BonoboRunningContext;
</pre>
<p>
the running context data
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679437"></a><h3>
<a name="BonoboRunningContextClass"></a>BonoboRunningContextClass</h3>
<a class="indexterm" name="id2679449"></a><pre class="programlisting">typedef struct {
BonoboObjectClass parent;
POA_Bonobo_RunningContext__epv epv;
void (*last_unref) (void);
} BonoboRunningContextClass;
</pre>
<p>
the running context class
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679467"></a><h3>
<a name="bonobo-running-context-new"></a>bonobo_running_context_new ()</h3>
<a class="indexterm" name="id2679481"></a><pre class="programlisting"><a href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a>* bonobo_running_context_new (void);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><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="id2679516"></a><h3>
<a name="bonobo-running-context-ignore-object"></a>bonobo_running_context_ignore_object ()</h3>
<a class="indexterm" name="id2679530"></a><pre class="programlisting">void bonobo_running_context_ignore_object
(CORBA_Object object);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679577"></a><h3>
<a name="bonobo-running-context-at-exit-unref"></a>bonobo_running_context_at_exit_unref ()</h3>
<a class="indexterm" name="id2679591"></a><pre class="programlisting">void bonobo_running_context_at_exit_unref
(CORBA_Object object);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2679640"></a><h2>See Also</h2>
<p>
<a href="libbonobo-bonobo-generic-factory.html" title="BonoboGenericFactory"><a name="id2707346"></a><span class="refentrytitle">BonoboGenericFactory</span>(3)</a>
</p>
</div>
</div>
</body>
</html>