← Back to branch summary

~ubuntu-branches/ubuntu/saucy/libbonobo/saucy-proposed

« back to all changes in this revision

Viewing changes to doc/api/html/libbonobo-bonobo-context.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-30 13:59:10 UTC
  • mfrom: (1.1.27 upstream)
  • Revision ID: james.westby@ubuntu.com-20100330135910-bq8awt4jhdd71oq1
Tags: 2.24.3-0ubuntu1
* New upstream version:
  - Set up dbus environment in test-activation/test.sh 
  - Fix memory corruption 
  - Updated translations 

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/api/html/libbonobo-bonobo-context.html
8
8
<link rel="up" href="general.html" title="General">
9
9
<link rel="prev" href="libbonobo-bonobo-types.html" title="bonobo-types">
10
10
<link rel="next" href="libbonobo-bonobo-exception.html" title="bonobo-exception">
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="general.html" title="General">
14
14
<link rel="chapter" href="factories.html" title="Objects, Factories, Reference Counting">
30
30
</tr>
31
31
<tr><td colspan="5" class="shortcuts">
32
32
<a href="#libbonobo-bonobo-context.synopsis" class="shortcut">Top</a>
33
 
                 | 
34
 
                <a href="#libbonobo-bonobo-context.description" class="shortcut">Description</a>
 
33
                   | 
 
34
                  <a href="#libbonobo-bonobo-context.description" class="shortcut">Description</a>
35
35
</td></tr>
36
36
</table>
37
37
<div class="refentry" title="bonobo-context">
45
45
</tr></table></div>
46
46
<div class="refsynopsisdiv" title="Synopsis">
47
47
<a name="libbonobo-bonobo-context.synopsis"></a><h2>Synopsis</h2>
48
 
<pre class="synopsis">
49
 
Bonobo_Unknown      <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-get" title="bonobo_context_get ()">bonobo_context_get</a>                  (const CORBA_char *context_name,
50
 
                                                         CORBA_Environment *opt_ev);
51
 
void                <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-add" title="bonobo_context_add ()">bonobo_context_add</a>                  (const CORBA_char *context_name,
52
 
                                                         Bonobo_Unknown context);
53
 
<a class="link" href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a> *      <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-running-get" title="bonobo_context_running_get ()">bonobo_context_running_get</a>          (void);
54
 
void                <a class="link" href="libbonobo-bonobo-context.html#bonobo-running-context-auto-exit-unref" title="bonobo_running_context_auto_exit_unref ()">bonobo_running_context_auto_exit_unref</a>
55
 
                                                        (<a class="link" href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a> *object);
 
48
<pre class="synopsis"><span class="returnvalue">Bonobo_Unknown</span>      <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-get" title="bonobo_context_get ()">bonobo_context_get</a>                  (const <span class="returnvalue">CORBA_char</span> *context_name,
 
49
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);
 
50
<span class="returnvalue">void</span>                <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-add" title="bonobo_context_add ()">bonobo_context_add</a>                  (const <span class="returnvalue">CORBA_char</span> *context_name,
 
51
                                                         <span class="returnvalue">Bonobo_Unknown</span> context);
 
52
<a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *      <a class="link" href="libbonobo-bonobo-context.html#bonobo-context-running-get" title="bonobo_context_running_get ()">bonobo_context_running_get</a>          (void);
 
53
<span class="returnvalue">void</span>                <a class="link" href="libbonobo-bonobo-context.html#bonobo-running-context-auto-exit-unref" title="bonobo_running_context_auto_exit_unref ()">bonobo_running_context_auto_exit_unref</a>
 
54
                                                        (<a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *object);
56
55
</pre>
57
56
</div>
58
57
<div class="refsect1" title="Description">
69
68
<p>
70
69
  </p>
71
70
<div class="example">
72
 
<a name="id2951586"></a><p class="title"><b>Example 1. Getting and using the moniker context</b></p>
73
 
<div class="example-contents"><pre class="programlisting">
74
 
Bonobo_MonikerContext context;
 
71
<a name="id2588497"></a><p class="title"><b>Example 1. Getting and using the moniker context</b></p>
 
72
<div class="example-contents">
 
73
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
74
    <tbody>
 
75
      <tr>
 
76
        <td class="listing_lines" align="right"><pre>1
 
77
2
 
78
3
 
79
4
 
80
5
 
81
6
 
82
7
 
83
8</pre></td>
 
84
        <td class="listing_code"><pre class="programlisting">Bonobo_MonikerContext context;
75
85
Bonobo_Unknown        object;
76
 
context = bonobo_context_get ("Activation", NULL);
77
 
if (context == CORBA_OBJECT_NIL)
78
 
        g_error (_("Internal error, no activation context"));
 
86
context = bonobo_context_get (<span class="number">&quot;Activation&quot;</span>, <span class="number">NULL</span>);
 
87
<span class="keyword">if</span> (context == CORBA_OBJECT_NIL)
 
88
        g_error (_(<span class="number">&quot;Internal error, no activation context&quot;</span>));
79
89
object = Bonobo_MonikerContext_getObject (
80
 
        "file:/demo/a.jpeg", "Bonobo/Control", ev);
81
 
...
82
 
     </pre></div>
 
90
        <span class="number">&quot;file:/demo/a.jpeg&quot;</span>, <span class="number">&quot;Bonobo/Control&quot;</span>, ev);
 
91
...</pre></td>
 
92
      </tr>
 
93
    </tbody>
 
94
  </table>
 
95
</div>
 
96
 
83
97
</div>
84
98
<p><br class="example-break">
85
99
</p>
106
120
<p>
107
121
  </p>
108
122
<div class="example">
109
 
<a name="id2951636"></a><p class="title"><b>Example 2. How to get a factory to quit when it is idle</b></p>
110
 
<div class="example-contents"><pre class="programlisting">
111
 
static void
 
123
<a name="id2588552"></a><p class="title"><b>Example 2. How to get a factory to quit when it is idle</b></p>
 
124
<div class="example-contents">
 
125
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
126
    <tbody>
 
127
      <tr>
 
128
        <td class="listing_lines" align="right"><pre>1
 
129
2
 
130
3
 
131
4
 
132
5
 
133
6
 
134
7
 
135
8
 
136
9
 
137
10
 
138
11
 
139
12
 
140
13
 
141
14
 
142
15
 
143
16
 
144
17</pre></td>
 
145
        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">void</span>
112
146
last_unref_exit_cb (gpointer      context,
113
 
                    BonoboObject *factory)
 
147
                    BonoboObject *factory)
114
148
{
115
149
        bonobo_object_unref (factory);
116
 
        gtk_main_quit ();
 
150
        gtk_main_quit ();
117
151
}
118
152
...
119
 
int main (int argc, char **argv)
 
153
<span class="type">int</span> main (<span class="type">int</span> argc, <span class="type">char</span> **argv)
120
154
{
121
 
        ...
122
 
        bonobo_running_context_ignore_object (BONOBO_OBJREF (object));
123
 
        gtk_signal_connect (GTK_OBJECT (bonobo_context_running_get ()),
124
 
                            "last_unref", last_unref_exit_cb, factory);
125
 
        ...
126
 
        bonobo_main ();
127
 
}
128
 
    </pre></div>
 
155
        ...
 
156
        bonobo_running_context_ignore_object (BONOBO_OBJREF (object));
 
157
        gtk_signal_connect (GTK_OBJECT (bonobo_context_running_get ()),
 
158
                            <span class="number">&quot;last_unref&quot;</span>, last_unref_exit_cb, factory);
 
159
        ...
 
160
        bonobo_main ();
 
161
}</pre></td>
 
162
      </tr>
 
163
    </tbody>
 
164
  </table>
 
165
</div>
 
166
 
129
167
</div>
130
168
<p><br class="example-break">
131
169
</p>
134
172
easier:
135
173
  </p>
136
174
<div class="example">
137
 
<a name="id2951660"></a><p class="title"><b>Example 3. How to get a factory to quit when it is idle</b></p>
138
 
<div class="example-contents"><pre class="programlisting">
139
 
bonobo_running_context_auto_exit_unref (factory)
140
 
    </pre></div>
 
175
<a name="id2588578"></a><p class="title"><b>Example 3. How to get a factory to quit when it is idle</b></p>
 
176
<div class="example-contents">
 
177
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
178
    <tbody>
 
179
      <tr>
 
180
        <td class="listing_lines" align="right"><pre>1</pre></td>
 
181
        <td class="listing_code"><pre class="programlisting">bonobo_running_context_auto_exit_unref (factory)</pre></td>
 
182
      </tr>
 
183
    </tbody>
 
184
  </table>
 
185
</div>
 
186
 
141
187
</div>
142
188
<p><br class="example-break">
143
189
</p>
146
192
<a name="libbonobo-bonobo-context.details"></a><h2>Details</h2>
147
193
<div class="refsect2" title="bonobo_context_get ()">
148
194
<a name="bonobo-context-get"></a><h3>bonobo_context_get ()</h3>
149
 
<pre class="programlisting">Bonobo_Unknown      bonobo_context_get                  (const CORBA_char *context_name,
150
 
                                                         CORBA_Environment *opt_ev);</pre>
 
195
<pre class="programlisting"><span class="returnvalue">Bonobo_Unknown</span>      bonobo_context_get                  (const <span class="returnvalue">CORBA_char</span> *context_name,
 
196
                                                         <span class="returnvalue">CORBA_Environment</span> *opt_ev);</pre>
151
197
<p>
152
198
The most useful context is named 'Activation' and returns
153
199
the IDL:Bonobo/ActivationContext:1.0 interface.</p>
154
 
<p>
155
 
</p>
156
200
<div class="variablelist"><table border="0">
157
201
<col align="left" valign="top">
158
202
<tbody>
177
221
<hr>
178
222
<div class="refsect2" title="bonobo_context_add ()">
179
223
<a name="bonobo-context-add"></a><h3>bonobo_context_add ()</h3>
180
 
<pre class="programlisting">void                bonobo_context_add                  (const CORBA_char *context_name,
181
 
                                                         Bonobo_Unknown context);</pre>
 
224
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_context_add                  (const <span class="returnvalue">CORBA_char</span> *context_name,
 
225
                                                         <span class="returnvalue">Bonobo_Unknown</span> context);</pre>
182
226
<p>
183
227
This function adds a new context to the context system</p>
184
 
<p>
185
 
</p>
186
228
<div class="variablelist"><table border="0">
187
229
<col align="left" valign="top">
188
230
<tbody>
202
244
<hr>
203
245
<div class="refsect2" title="bonobo_context_running_get ()">
204
246
<a name="bonobo-context-running-get"></a><h3>bonobo_context_running_get ()</h3>
205
 
<pre class="programlisting"><a class="link" href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a> *      bonobo_context_running_get          (void);</pre>
 
247
<pre class="programlisting"><a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *      bonobo_context_running_get          (void);</pre>
206
248
<p>
207
249
</p>
208
250
<div class="variablelist"><table border="0">
217
259
<hr>
218
260
<div class="refsect2" title="bonobo_running_context_auto_exit_unref ()">
219
261
<a name="bonobo-running-context-auto-exit-unref"></a><h3>bonobo_running_context_auto_exit_unref ()</h3>
220
 
<pre class="programlisting">void                bonobo_running_context_auto_exit_unref
221
 
                                                        (<a class="link" href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a> *object);</pre>
 
262
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_running_context_auto_exit_unref
 
263
                                                        (<a class="link" href="libbonobo-bonobo-object.html#BonoboObject"><span class="returnvalue">BonoboObject</span></a> *object);</pre>
222
264
<p>
223
265
</p>
224
266
<div class="variablelist"><table border="0">
234
276
</div>
235
277
<div class="footer">
236
278
<hr>
237
 
          Generated by GTK-Doc V1.11</div>
 
279
          Generated by GTK-Doc V1.14</div>
238
280
</body>
239
 
</html>
 
281
</html>
 
 
b'\\ No newline at end of file'