~timchen119/ubuntu/trusty/gnome-bluetooth/lp1035431

« back to all changes in this revision

Viewing changes to docs/reference/libgnome-bluetooth/html/gnome-bluetooth-bluetooth-chooser.html

  • Committer: Bazaar Package Importer
  • Author(s): Emilio Pozuelo Monfort
  • Date: 2011-02-27 15:45:22 UTC
  • mfrom: (1.3.2 upstream)
  • mto: (2.2.3 experimental) (1.5.1)
  • mto: This revision was merged to the branch mainline in revision 53.
  • Revision ID: james.westby@ubuntu.com-20110227154522-dnnoqasv5v3mv42a
Tags: upstream-2.91.5
Import upstream version 2.91.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>BluetoothChooser</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
7
<link rel="home" href="index.html" title="gnome-bluetooth Reference Manual">
 
8
<link rel="up" href="ch01.html" title="API Reference">
 
9
<link rel="prev" href="ch01.html" title="API Reference">
 
10
<link rel="next" href="gnome-bluetooth-bluetooth-client.html" title="BluetoothClient">
 
11
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
</head>
 
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">gnome-bluetooth Reference Manual</th>
 
21
<td><a accesskey="n" href="gnome-bluetooth-bluetooth-client.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#gnome-bluetooth-bluetooth-chooser.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#gnome-bluetooth-bluetooth-chooser.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#gnome-bluetooth-bluetooth-chooser.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#gnome-bluetooth-bluetooth-chooser.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
                   | 
 
32
                  <a href="#gnome-bluetooth-bluetooth-chooser.properties" class="shortcut">Properties</a>
 
33
                   | 
 
34
                  <a href="#gnome-bluetooth-bluetooth-chooser.signals" class="shortcut">Signals</a>
 
35
</td></tr>
 
36
</table>
 
37
<div class="refentry">
 
38
<a name="gnome-bluetooth-bluetooth-chooser"></a><div class="titlepage"></div>
 
39
<div class="refnamediv"><table width="100%"><tr>
 
40
<td valign="top">
 
41
<h2><span class="refentrytitle"><a name="gnome-bluetooth-bluetooth-chooser.top_of_page"></a>BluetoothChooser</span></h2>
 
42
<p>BluetoothChooser — a Bluetooth chooser widget</p>
 
43
</td>
 
44
<td valign="top" align="right"></td>
 
45
</tr></table></div>
 
46
<div class="refsect1">
 
47
<a name="gnome-bluetooth-bluetooth-chooser.stability-level"></a><h2>Stability Level</h2>
 
48
Stable, unless otherwise indicated
 
49
</div>
 
50
<div class="refsynopsisdiv">
 
51
<a name="gnome-bluetooth-bluetooth-chooser.synopsis"></a><h2>Synopsis</h2>
 
52
<a name="BluetoothChooser"></a><pre class="synopsis">
 
53
#include &lt;bluetooth-plugin.h&gt;
 
54
 
 
55
#define             <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BLUETOOTH-GET-CHOOSER-CLASS:CAPS" title="BLUETOOTH_GET_CHOOSER_CLASS()">BLUETOOTH_GET_CHOOSER_CLASS</a>         (obj)
 
56
struct              <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser-struct" title="struct BluetoothChooser">BluetoothChooser</a>;
 
57
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-new" title="bluetooth_chooser_new ()">bluetooth_chooser_new</a>               (<em class="parameter"><code>const <span class="type">char</span> *title</code></em>);
 
58
<span class="returnvalue">void</span>                <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-set-title" title="bluetooth_chooser_set_title ()">bluetooth_chooser_set_title</a>         (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>,
 
59
                                                         <em class="parameter"><code>const <span class="type">char</span> *title</code></em>);
 
60
<span class="returnvalue">char</span> *              <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device" title="bluetooth_chooser_get_selected_device ()">bluetooth_chooser_get_selected_device</a>
 
61
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device-info" title="bluetooth_chooser_get_selected_device_info ()">bluetooth_chooser_get_selected_device_info</a>
 
63
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>,
 
64
                                                         <em class="parameter"><code>const <span class="type">char</span> *field</code></em>,
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
 
66
<span class="returnvalue">char</span> *              <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device-name" title="bluetooth_chooser_get_selected_device_name ()">bluetooth_chooser_get_selected_device_name</a>
 
67
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
68
<span class="returnvalue">char</span> *              <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device-icon" title="bluetooth_chooser_get_selected_device_icon ()">bluetooth_chooser_get_selected_device_icon</a>
 
69
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
70
<a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothType" title="enum BluetoothType"><span class="returnvalue">BluetoothType</span></a>       <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device-type" title="bluetooth_chooser_get_selected_device_type ()">bluetooth_chooser_get_selected_device_type</a>
 
71
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
72
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-get-selected-device-is-connected" title="bluetooth_chooser_get_selected_device_is_connected ()">bluetooth_chooser_get_selected_device_is_connected</a>
 
73
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
74
<span class="returnvalue">void</span>                <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-start-discovery" title="bluetooth_chooser_start_discovery ()">bluetooth_chooser_start_discovery</a>   (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
75
<span class="returnvalue">void</span>                <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-stop-discovery" title="bluetooth_chooser_stop_discovery ()">bluetooth_chooser_stop_discovery</a>    (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);
 
76
</pre>
 
77
</div>
 
78
<div class="refsect1">
 
79
<a name="gnome-bluetooth-bluetooth-chooser.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
80
<pre class="synopsis">
 
81
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
82
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
83
         +----<a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html">GtkWidget</a>
 
84
               +----<a href="http://library.gnome.org/devel/gtk/unstable/GtkContainer.html">GtkContainer</a>
 
85
                     +----<a href="http://library.gnome.org/devel/gtk/unstable/GtkBox.html">GtkBox</a>
 
86
                           +----<a href="http://library.gnome.org/devel/gtk/unstable/GtkVBox.html">GtkVBox</a>
 
87
                                 +----BluetoothChooser
 
88
</pre>
 
89
</div>
 
90
<div class="refsect1">
 
91
<a name="gnome-bluetooth-bluetooth-chooser.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 
92
<p>
 
93
BluetoothChooser implements
 
94
 AtkImplementorIface,  <a href="http://library.gnome.org/devel/gtk/unstable/GtkBuildable.html">GtkBuildable</a> and  <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
 
95
</div>
 
96
<div class="refsect1">
 
97
<a name="gnome-bluetooth-bluetooth-chooser.properties"></a><h2>Properties</h2>
 
98
<pre class="synopsis">
 
99
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--device-category-filter" title='The "device-category-filter" property'>device-category-filter</a>"   <a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothCategory" title="enum BluetoothCategory"><span class="type">BluetoothCategory</span></a>     : Read / Write / Construct
 
100
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--device-selected" title='The "device-selected" property'>device-selected</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
101
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--device-service-filter" title='The "device-service-filter" property'>device-service-filter</a>"    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write
 
102
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--device-type-filter" title='The "device-type-filter" property'>device-type-filter</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write / Construct
 
103
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--has-internal-device-filter" title='The "has-internal-device-filter" property'>has-internal-device-filter</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct Only
 
104
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-connected" title='The "show-connected" property'>show-connected</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
105
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-device-category" title='The "show-device-category" property'>show-device-category</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
 
106
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-device-type" title='The "show-device-type" property'>show-device-type</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
 
107
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-pairing" title='The "show-pairing" property'>show-pairing</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
108
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-searching" title='The "show-searching" property'>show-searching</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
109
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--title" title='The "title" property'>title</a>"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write
 
110
</pre>
 
111
</div>
 
112
<div class="refsect1">
 
113
<a name="gnome-bluetooth-bluetooth-chooser.signals"></a><h2>Signals</h2>
 
114
<pre class="synopsis">
 
115
  "<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser-selected-device-changed" title='The "selected-device-changed" signal'>selected-device-changed</a>"                        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
116
</pre>
 
117
</div>
 
118
<div class="refsect1">
 
119
<a name="gnome-bluetooth-bluetooth-chooser.description"></a><h2>Description</h2>
 
120
<p>
 
121
A tree-like widget used to select Bluetooth devices.
 
122
</p>
 
123
</div>
 
124
<div class="refsect1">
 
125
<a name="gnome-bluetooth-bluetooth-chooser.details"></a><h2>Details</h2>
 
126
<div class="refsect2">
 
127
<a name="BLUETOOTH-GET-CHOOSER-CLASS:CAPS"></a><h3>BLUETOOTH_GET_CHOOSER_CLASS()</h3>
 
128
<pre class="programlisting">#define             BLUETOOTH_GET_CHOOSER_CLASS(obj)</pre>
 
129
<p>
 
130
</p>
 
131
</div>
 
132
<hr>
 
133
<div class="refsect2">
 
134
<a name="BluetoothChooser-struct"></a><h3>struct BluetoothChooser</h3>
 
135
<pre class="programlisting">struct BluetoothChooser;</pre>
 
136
<p>
 
137
</p>
 
138
</div>
 
139
<hr>
 
140
<div class="refsect2">
 
141
<a name="bluetooth-chooser-new"></a><h3>bluetooth_chooser_new ()</h3>
 
142
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *         bluetooth_chooser_new               (<em class="parameter"><code>const <span class="type">char</span> *title</code></em>);</pre>
 
143
<p>
 
144
Returns a new <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.
 
145
</p>
 
146
<div class="variablelist"><table border="0">
 
147
<col align="left" valign="top">
 
148
<tbody>
 
149
<tr>
 
150
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
 
151
<td>the widget header title, if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the widget header will be hidden.</td>
 
152
</tr>
 
153
<tr>
 
154
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
155
<td>A <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget</td>
 
156
</tr>
 
157
</tbody>
 
158
</table></div>
 
159
</div>
 
160
<hr>
 
161
<div class="refsect2">
 
162
<a name="bluetooth-chooser-set-title"></a><h3>bluetooth_chooser_set_title ()</h3>
 
163
<pre class="programlisting"><span class="returnvalue">void</span>                bluetooth_chooser_set_title         (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>,
 
164
                                                         <em class="parameter"><code>const <span class="type">char</span> *title</code></em>);</pre>
 
165
<p>
 
166
Sets the <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a>'s title.
 
167
</p>
 
168
<div class="variablelist"><table border="0">
 
169
<col align="left" valign="top">
 
170
<tbody>
 
171
<tr>
 
172
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
173
<td>a BluetoothChooser widget.</td>
 
174
</tr>
 
175
<tr>
 
176
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
 
177
<td>the widget header title.</td>
 
178
</tr>
 
179
</tbody>
 
180
</table></div>
 
181
</div>
 
182
<hr>
 
183
<div class="refsect2">
 
184
<a name="bluetooth-chooser-get-selected-device"></a><h3>bluetooth_chooser_get_selected_device ()</h3>
 
185
<pre class="programlisting"><span class="returnvalue">char</span> *              bluetooth_chooser_get_selected_device
 
186
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
187
<p>
 
188
Returns the Bluetooth address for the currently selected device.
 
189
</p>
 
190
<div class="variablelist"><table border="0">
 
191
<col align="left" valign="top">
 
192
<tbody>
 
193
<tr>
 
194
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
195
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
196
</tr>
 
197
<tr>
 
198
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
199
<td>the Bluetooth address for the currently selected device, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 
200
</tr>
 
201
</tbody>
 
202
</table></div>
 
203
</div>
 
204
<hr>
 
205
<div class="refsect2">
 
206
<a name="bluetooth-chooser-get-selected-device-info"></a><h3>bluetooth_chooser_get_selected_device_info ()</h3>
 
207
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            bluetooth_chooser_get_selected_device_info
 
208
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>,
 
209
                                                         <em class="parameter"><code>const <span class="type">char</span> *field</code></em>,
 
210
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 
211
<p>
 
212
Returns whether the <em class="parameter"><code>value</code></em> has been set.
 
213
</p>
 
214
<div class="variablelist"><table border="0">
 
215
<col align="left" valign="top">
 
216
<tbody>
 
217
<tr>
 
218
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
219
<td>A <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
220
</tr>
 
221
<tr>
 
222
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
 
223
<td>The identifier for the field to get data for.</td>
 
224
</tr>
 
225
<tr>
 
226
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 
227
<td>An empty <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to set.</td>
 
228
</tr>
 
229
<tr>
 
230
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
231
<td>
 
232
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>value</code></em> has been set.</td>
 
233
</tr>
 
234
</tbody>
 
235
</table></div>
 
236
</div>
 
237
<hr>
 
238
<div class="refsect2">
 
239
<a name="bluetooth-chooser-get-selected-device-name"></a><h3>bluetooth_chooser_get_selected_device_name ()</h3>
 
240
<pre class="programlisting"><span class="returnvalue">char</span> *              bluetooth_chooser_get_selected_device_name
 
241
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
242
<p>
 
243
Returns the name for the currently selected device.
 
244
</p>
 
245
<div class="variablelist"><table border="0">
 
246
<col align="left" valign="top">
 
247
<tbody>
 
248
<tr>
 
249
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
250
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
251
</tr>
 
252
<tr>
 
253
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
254
<td>the name for the currently selected device, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 
255
</tr>
 
256
</tbody>
 
257
</table></div>
 
258
</div>
 
259
<hr>
 
260
<div class="refsect2">
 
261
<a name="bluetooth-chooser-get-selected-device-icon"></a><h3>bluetooth_chooser_get_selected_device_icon ()</h3>
 
262
<pre class="programlisting"><span class="returnvalue">char</span> *              bluetooth_chooser_get_selected_device_icon
 
263
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
264
<p>
 
265
Returns the icon name to use to represent the currently selected device.
 
266
</p>
 
267
<div class="variablelist"><table border="0">
 
268
<col align="left" valign="top">
 
269
<tbody>
 
270
<tr>
 
271
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
272
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
273
</tr>
 
274
<tr>
 
275
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
276
<td>the icon name to use to represent the currently selected device, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 
277
</tr>
 
278
</tbody>
 
279
</table></div>
 
280
</div>
 
281
<hr>
 
282
<div class="refsect2">
 
283
<a name="bluetooth-chooser-get-selected-device-type"></a><h3>bluetooth_chooser_get_selected_device_type ()</h3>
 
284
<pre class="programlisting"><a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothType" title="enum BluetoothType"><span class="returnvalue">BluetoothType</span></a>       bluetooth_chooser_get_selected_device_type
 
285
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
286
<p>
 
287
Returns the <a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothType" title="enum BluetoothType"><span class="type">BluetoothType</span></a> of the device selected.
 
288
</p>
 
289
<div class="variablelist"><table border="0">
 
290
<col align="left" valign="top">
 
291
<tbody>
 
292
<tr>
 
293
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
294
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
295
</tr>
 
296
<tr>
 
297
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
298
<td>the <a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothType" title="enum BluetoothType"><span class="type">BluetoothType</span></a> of the device selected, or '0' if unknown.</td>
 
299
</tr>
 
300
</tbody>
 
301
</table></div>
 
302
</div>
 
303
<hr>
 
304
<div class="refsect2">
 
305
<a name="bluetooth-chooser-get-selected-device-is-connected"></a><h3>bluetooth_chooser_get_selected_device_is_connected ()</h3>
 
306
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            bluetooth_chooser_get_selected_device_is_connected
 
307
                                                        (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
308
<p>
 
309
Returns whether the selected device is connected to this computer.
 
310
</p>
 
311
<div class="variablelist"><table border="0">
 
312
<col align="left" valign="top">
 
313
<tbody>
 
314
<tr>
 
315
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
316
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
317
</tr>
 
318
<tr>
 
319
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
320
<td>whether the selected device is connected to this computer,
 
321
will always be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if no devices are selected.</td>
 
322
</tr>
 
323
</tbody>
 
324
</table></div>
 
325
</div>
 
326
<hr>
 
327
<div class="refsect2">
 
328
<a name="bluetooth-chooser-start-discovery"></a><h3>bluetooth_chooser_start_discovery ()</h3>
 
329
<pre class="programlisting"><span class="returnvalue">void</span>                bluetooth_chooser_start_discovery   (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
330
<p>
 
331
Starts a discovery on the default Bluetooth adapter. Note that this will
 
332
only work if the Search label is visible, as otherwise the user has no
 
333
visual feedback that the process is on-going.
 
334
</p>
 
335
<p>
 
336
See also: <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser--show-searching" title='The "show-searching" property'><span class="type">"show-searching"</span></a>
 
337
</p>
 
338
<div class="variablelist"><table border="0">
 
339
<col align="left" valign="top">
 
340
<tbody><tr>
 
341
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
342
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
343
</tr></tbody>
 
344
</table></div>
 
345
</div>
 
346
<hr>
 
347
<div class="refsect2">
 
348
<a name="bluetooth-chooser-stop-discovery"></a><h3>bluetooth_chooser_stop_discovery ()</h3>
 
349
<pre class="programlisting"><span class="returnvalue">void</span>                bluetooth_chooser_stop_discovery    (<em class="parameter"><code><a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *self</code></em>);</pre>
 
350
<p>
 
351
Stops a discovery started with <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#bluetooth-chooser-start-discovery" title="bluetooth_chooser_start_discovery ()"><span class="type">bluetooth_chooser_start_discovery</span></a>.
 
352
</p>
 
353
<div class="variablelist"><table border="0">
 
354
<col align="left" valign="top">
 
355
<tbody><tr>
 
356
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
357
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.</td>
 
358
</tr></tbody>
 
359
</table></div>
 
360
</div>
 
361
</div>
 
362
<div class="refsect1">
 
363
<a name="gnome-bluetooth-bluetooth-chooser.property-details"></a><h2>Property Details</h2>
 
364
<div class="refsect2">
 
365
<a name="BluetoothChooser--device-category-filter"></a><h3>The <code class="literal">"device-category-filter"</code> property</h3>
 
366
<pre class="programlisting">  "device-category-filter"   <a class="link" href="gnome-bluetooth-bluetooth-enums.html#BluetoothCategory" title="enum BluetoothCategory"><span class="type">BluetoothCategory</span></a>     : Read / Write / Construct</pre>
 
367
<p>The #BluetoothCategory to show.</p>
 
368
<p>Default value: BLUETOOTH_CATEGORY_ALL</p>
 
369
</div>
 
370
<hr>
 
371
<div class="refsect2">
 
372
<a name="BluetoothChooser--device-selected"></a><h3>The <code class="literal">"device-selected"</code> property</h3>
 
373
<pre class="programlisting">  "device-selected"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
374
<p>the Bluetooth address for the currently selected device, or %NULL.</p>
 
375
<p>Default value: NULL</p>
 
376
</div>
 
377
<hr>
 
378
<div class="refsect2">
 
379
<a name="BluetoothChooser--device-service-filter"></a><h3>The <code class="literal">"device-service-filter"</code> property</h3>
 
380
<pre class="programlisting">  "device-service-filter"    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write</pre>
 
381
<p>A string representing the service to filter for.</p>
 
382
<p>Default value: NULL</p>
 
383
</div>
 
384
<hr>
 
385
<div class="refsect2">
 
386
<a name="BluetoothChooser--device-type-filter"></a><h3>The <code class="literal">"device-type-filter"</code> property</h3>
 
387
<pre class="programlisting">  "device-type-filter"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write / Construct</pre>
 
388
<p>A bitmask of #BluetoothType to show.</p>
 
389
<p>Allowed values: [1,32767]</p>
 
390
<p>Default value: 1</p>
 
391
</div>
 
392
<hr>
 
393
<div class="refsect2">
 
394
<a name="BluetoothChooser--has-internal-device-filter"></a><h3>The <code class="literal">"has-internal-device-filter"</code> property</h3>
 
395
<pre class="programlisting">  "has-internal-device-filter" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct Only</pre>
 
396
<p>Whether the #BluetoothChooser should be constructed with a visible #BluetoothFilterWidget.</p>
 
397
<p>Default value: TRUE</p>
 
398
</div>
 
399
<hr>
 
400
<div class="refsect2">
 
401
<a name="BluetoothChooser--show-connected"></a><h3>The <code class="literal">"show-connected"</code> property</h3>
 
402
<pre class="programlisting">  "show-connected"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
403
<p>Whether to show the connected column in the tree.</p>
 
404
<p>Default value: FALSE</p>
 
405
</div>
 
406
<hr>
 
407
<div class="refsect2">
 
408
<a name="BluetoothChooser--show-device-category"></a><h3>The <code class="literal">"show-device-category"</code> property</h3>
 
409
<pre class="programlisting">  "show-device-category"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
 
410
<p>Whether to show the device category filter.</p>
 
411
<p>Default value: TRUE</p>
 
412
</div>
 
413
<hr>
 
414
<div class="refsect2">
 
415
<a name="BluetoothChooser--show-device-type"></a><h3>The <code class="literal">"show-device-type"</code> property</h3>
 
416
<pre class="programlisting">  "show-device-type"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
 
417
<p>Whether to show the device type filter.</p>
 
418
<p>Default value: TRUE</p>
 
419
</div>
 
420
<hr>
 
421
<div class="refsect2">
 
422
<a name="BluetoothChooser--show-pairing"></a><h3>The <code class="literal">"show-pairing"</code> property</h3>
 
423
<pre class="programlisting">  "show-pairing"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
424
<p>Whether to show the pairing column in the tree.</p>
 
425
<p>Default value: FALSE</p>
 
426
</div>
 
427
<hr>
 
428
<div class="refsect2">
 
429
<a name="BluetoothChooser--show-searching"></a><h3>The <code class="literal">"show-searching"</code> property</h3>
 
430
<pre class="programlisting">  "show-searching"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
431
<p>Whether to show the Searching label , this is necessary if you want to programmatically start a discovery, using bluetooth_chooser_start_discovery().</p>
 
432
<p>Default value: FALSE</p>
 
433
</div>
 
434
<hr>
 
435
<div class="refsect2">
 
436
<a name="BluetoothChooser--title"></a><h3>The <code class="literal">"title"</code> property</h3>
 
437
<pre class="programlisting">  "title"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write</pre>
 
438
<p>The widget header title.</p>
 
439
<p>Default value: NULL</p>
 
440
</div>
 
441
</div>
 
442
<div class="refsect1">
 
443
<a name="gnome-bluetooth-bluetooth-chooser.signal-details"></a><h2>Signal Details</h2>
 
444
<div class="refsect2">
 
445
<a name="BluetoothChooser-selected-device-changed"></a><h3>The <code class="literal">"selected-device-changed"</code> signal</h3>
 
446
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> *chooser,
 
447
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *address,
 
448
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
449
<p>
 
450
The <span class="type">"selected-device-changed"</span> signal is launched when the
 
451
selected device is changed, it will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if a device was unselected.
 
452
</p>
 
453
<div class="variablelist"><table border="0">
 
454
<col align="left" valign="top">
 
455
<tbody>
 
456
<tr>
 
457
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
 
458
<td>a <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget which received the signal</td>
 
459
</tr>
 
460
<tr>
 
461
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
 
462
<td>the Bluetooth address for the currently selected device, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
463
</td>
 
464
</tr>
 
465
<tr>
 
466
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
467
<td>user data set when the signal handler was connected.</td>
 
468
</tr>
 
469
</tbody>
 
470
</table></div>
 
471
</div>
 
472
</div>
 
473
</div>
 
474
<div class="footer">
 
475
<hr>
 
476
          Generated by GTK-Doc V1.15.1</div>
 
477
</body>
 
478
</html>
 
 
b'\\ No newline at end of file'