4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>BonoboSelector</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.2">
7
7
<link rel="home" href="index.html" title="LibBonoboUI API Reference Manual">
8
8
<link rel="up" href="bonobo-support-utilities.html" title="Supporting Classes">
9
9
<link rel="prev" href="libbonoboui-bonobo-wrapper.html" title="bonobo-wrapper">
10
10
<link rel="next" href="libbonoboui-bonobo-selector-widget.html" title="bonobo-selector-widget">
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.11 (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">
25
25
<th width="100%" align="center">LibBonoboUI API Reference Manual</th>
26
26
<td><a accesskey="n" href="libbonoboui-bonobo-selector-widget.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28
<tr><td colspan="5" class="shortcuts"><nobr><a href="#libbonoboui-bonobo-selector.synopsis" class="shortcut">Top</a>
30
<a href="#libbonoboui-bonobo-selector.description" class="shortcut">Description</a>
32
<a href="#libbonoboui-bonobo-selector.object-hierarchy" class="shortcut">Object Hierarchy</a>
34
<a href="#libbonoboui-bonobo-selector.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
36
<a href="#libbonoboui-bonobo-selector.properties" class="shortcut">Properties</a>
38
<a href="#libbonoboui-bonobo-selector.signals" class="shortcut">Signals</a></nobr></td></tr>
28
<tr><td colspan="5" class="shortcuts">
29
<a href="#libbonoboui-bonobo-selector.synopsis" class="shortcut">Top</a>
31
<a href="#libbonoboui-bonobo-selector.description" class="shortcut">Description</a>
33
<a href="#libbonoboui-bonobo-selector.object-hierarchy" class="shortcut">Object Hierarchy</a>
35
<a href="#libbonoboui-bonobo-selector.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
37
<a href="#libbonoboui-bonobo-selector.properties" class="shortcut">Properties</a>
39
<a href="#libbonoboui-bonobo-selector.signals" class="shortcut">Signals</a>
40
42
<div class="refentry" lang="en">
41
43
<a name="libbonoboui-bonobo-selector"></a><div class="titlepage"></div>
52
54
<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelectorPrivate" title="BonoboSelectorPrivate">BonoboSelectorPrivate</a>;
53
55
<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector-struct" title="BonoboSelector">BonoboSelector</a>;
54
56
<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelectorClass" title="BonoboSelectorClass">BonoboSelectorClass</a>;
56
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
57
>GtkWidget</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-construct" title="bonobo_selector_construct ()">bonobo_selector_construct</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel,
57
GtkWidget * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-construct" title="bonobo_selector_construct ()">bonobo_selector_construct</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel,
59
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
59
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
61
61
<a class="link" href="libbonoboui-bonobo-selector-widget.html#BonoboSelectorWidget" title="BonoboSelectorWidget">BonoboSelectorWidget</a> *selector);
63
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
64
>GtkWidget</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-new" title="bonobo_selector_new ()">bonobo_selector_new</a> (const <a
65
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
62
GtkWidget * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-new" title="bonobo_selector_new ()">bonobo_selector_new</a> (const <a
63
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
68
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
66
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
69
67
>gchar</a> **interfaces_required);
71
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
72
>gchar</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-id" title="bonobo_selector_get_selected_id ()">bonobo_selector_get_selected_id</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);
74
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
75
>gchar</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-name" title="bonobo_selector_get_selected_name ()">bonobo_selector_get_selected_name</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);
77
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
78
>gchar</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-description" title="bonobo_selector_get_selected_description ()">bonobo_selector_get_selected_description</a>
69
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
70
>gchar</a> * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-id" title="bonobo_selector_get_selected_id ()">bonobo_selector_get_selected_id</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);
72
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
73
>gchar</a> * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-name" title="bonobo_selector_get_selected_name ()">bonobo_selector_get_selected_name</a> (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);
75
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
76
>gchar</a> * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-get-selected-description" title="bonobo_selector_get_selected_description ()">bonobo_selector_get_selected_description</a>
79
77
(<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);
81
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
82
>gchar</a>* <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-select-id" title="bonobo_selector_select_id ()">bonobo_selector_select_id</a> (const <a
83
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
79
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
80
>gchar</a> * <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-select-id" title="bonobo_selector_select_id ()">bonobo_selector_select_id</a> (const <a
81
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
86
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
84
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
87
85
>gchar</a> **interfaces_required);
91
89
<a name="libbonoboui-bonobo-selector.object-hierarchy"></a><h2>Object Hierarchy</h2>
92
90
<pre class="synopsis">
94
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
92
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
97
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
95
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
98
96
>GInitiallyUnowned</a>
100
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
103
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
106
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
109
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
112
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
115
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
117
103
+----BonoboSelector
121
107
<a name="libbonoboui-bonobo-selector.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
123
109
BonoboSelector implements
124
AtkImplementorIface and <a
125
href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable"
126
>GtkBuildable</a>.</p>
110
AtkImplementorIface and GtkBuildable.</p>
128
112
<div class="refsect1" lang="en">
129
113
<a name="libbonoboui-bonobo-selector.properties"></a><h2>Properties</h2>
130
114
<pre class="synopsis">
131
115
"<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector--interfaces-required" title='The "interfaces-required" property'>interfaces-required</a>" <a
132
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
116
href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
133
117
>GValueArray</a>* : Write / Construct
152
136
<div class="example">
153
<a name="id2897654"></a><p class="title"><b>Example 10. Simple Bonobo/Control selection</b></p>
137
<a name="id2659157"></a><p class="title"><b>Example 10. Simple Bonobo/Control selection</b></p>
154
138
<div class="example-contents"><pre class="programlisting">
156
140
char *interfaces [] = { "IDL:Bonobo/Control:1.0", NULL };
159
142
oaf_iid = bonobo_selector_select_id (
160
143
_("Please select a Control"), interfaces);
162
144
g_warning ("You selected '%s'", oaf_iid);
164
145
g_free (oaf_iid);
201
180
} BonoboSelectorClass;
208
186
<div class="refsect2" lang="en">
209
187
<a name="bonobo-selector-construct"></a><h3>bonobo_selector_construct ()</h3>
210
<pre class="programlisting"><a
211
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
212
>GtkWidget</a>* bonobo_selector_construct (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel,
188
<pre class="programlisting">GtkWidget * bonobo_selector_construct (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel,
214
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
190
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
215
191
>gchar</a> *title,
216
192
<a class="link" href="libbonoboui-bonobo-selector-widget.html#BonoboSelectorWidget" title="BonoboSelectorWidget">BonoboSelectorWidget</a> *selector);</pre>
251
226
<div class="refsect2" lang="en">
252
227
<a name="bonobo-selector-new"></a><h3>bonobo_selector_new ()</h3>
253
<pre class="programlisting"><a
254
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
255
>GtkWidget</a>* bonobo_selector_new (const <a
256
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
228
<pre class="programlisting">GtkWidget * bonobo_selector_new (const <a
229
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
257
230
>gchar</a> *title,
259
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
232
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
260
233
>gchar</a> **interfaces_required);</pre>
262
235
Creates a new BonoboSelector widget. The title of the dialog
294
266
<div class="refsect2" lang="en">
295
267
<a name="bonobo-selector-get-selected-id"></a><h3>bonobo_selector_get_selected_id ()</h3>
296
268
<pre class="programlisting"><a
297
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
298
>gchar</a>* bonobo_selector_get_selected_id (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);</pre>
269
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
270
>gchar</a> * bonobo_selector_get_selected_id (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);</pre>
304
275
<div class="variablelist"><table border="0">
305
276
<col align="left" valign="top">
324
295
<div class="refsect2" lang="en">
325
296
<a name="bonobo-selector-get-selected-name"></a><h3>bonobo_selector_get_selected_name ()</h3>
326
297
<pre class="programlisting"><a
327
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
328
>gchar</a>* bonobo_selector_get_selected_name (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);</pre>
298
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
299
>gchar</a> * bonobo_selector_get_selected_name (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);</pre>
334
304
<div class="variablelist"><table border="0">
335
305
<col align="left" valign="top">
354
324
<div class="refsect2" lang="en">
355
325
<a name="bonobo-selector-get-selected-description"></a><h3>bonobo_selector_get_selected_description ()</h3>
356
326
<pre class="programlisting"><a
357
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
358
>gchar</a>* bonobo_selector_get_selected_description
327
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
328
>gchar</a> * bonobo_selector_get_selected_description
359
329
(<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *sel);</pre>
365
334
<div class="variablelist"><table border="0">
366
335
<col align="left" valign="top">
385
354
<div class="refsect2" lang="en">
386
355
<a name="bonobo-selector-select-id"></a><h3>bonobo_selector_select_id ()</h3>
387
356
<pre class="programlisting"><a
388
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
389
>gchar</a>* bonobo_selector_select_id (const <a
390
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
357
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
358
>gchar</a> * bonobo_selector_select_id (const <a
359
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
391
360
>gchar</a> *title,
393
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
362
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
394
363
>gchar</a> **interfaces_required);</pre>
396
365
Calls <a class="link" href="libbonoboui-bonobo-selector.html#bonobo-selector-new" title="bonobo_selector_new ()"><code class="function">bonobo_selector_new()</code></a> to create a new
429
397
<div class="refsect2" lang="en">
430
398
<a name="BonoboSelector--interfaces-required"></a><h3>The <code class="literal">"interfaces-required"</code> property</h3>
431
399
<pre class="programlisting"> "interfaces-required" <a
432
href="/usr/share/gtk-doc/html/gobject/gobject-Value-arrays.html#GValueArray"
400
href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
433
401
>GValueArray</a>* : Write / Construct</pre>
434
402
<p>A NULL-terminated array of interfaces which a server must support in order to be listed in the selector. Defaults to "IDL:Bonobo/Embeddable:1.0" if no interfaces are listed.</p>
440
408
<a name="BonoboSelector-cancel"></a><h3>The <code class="literal">"cancel"</code> signal</h3>
441
409
<pre class="programlisting">void user_function (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *bonoboselector,
443
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
411
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
444
412
>gpointer</a> user_data) : Run Last</pre>
448
415
<div class="variablelist"><table border="0">
449
416
<col align="left" valign="top">
466
432
<a name="BonoboSelector-ok"></a><h3>The <code class="literal">"ok"</code> signal</h3>
467
433
<pre class="programlisting">void user_function (<a class="link" href="libbonoboui-bonobo-selector.html#BonoboSelector">BonoboSelector</a> *bonoboselector,
469
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
435
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
470
436
>gpointer</a> user_data) : Run Last</pre>
474
439
<div class="variablelist"><table border="0">
475
440
<col align="left" valign="top">