1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
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">
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">
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>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#gnome-bluetooth-bluetooth-chooser.synopsis" class="shortcut">Top</a>
26
<a href="#gnome-bluetooth-bluetooth-chooser.description" class="shortcut">Description</a>
28
<a href="#gnome-bluetooth-bluetooth-chooser.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
<a href="#gnome-bluetooth-bluetooth-chooser.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32
<a href="#gnome-bluetooth-bluetooth-chooser.properties" class="shortcut">Properties</a>
34
<a href="#gnome-bluetooth-bluetooth-chooser.signals" class="shortcut">Signals</a>
37
<div class="refentry">
38
<a name="gnome-bluetooth-bluetooth-chooser"></a><div class="titlepage"></div>
39
<div class="refnamediv"><table width="100%"><tr>
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>
44
<td valign="top" align="right"></td>
46
<div class="refsect1">
47
<a name="gnome-bluetooth-bluetooth-chooser.stability-level"></a><h2>Stability Level</h2>
48
Stable, unless otherwise indicated
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 <bluetooth-plugin.h>
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>);
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>
90
<div class="refsect1">
91
<a name="gnome-bluetooth-bluetooth-chooser.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
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>
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
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>
118
<div class="refsect1">
119
<a name="gnome-bluetooth-bluetooth-chooser.description"></a><h2>Description</h2>
121
A tree-like widget used to select Bluetooth devices.
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>
133
<div class="refsect2">
134
<a name="BluetoothChooser-struct"></a><h3>struct BluetoothChooser</h3>
135
<pre class="programlisting">struct BluetoothChooser;</pre>
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>
144
Returns a new <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a> widget.
146
<div class="variablelist"><table border="0">
147
<col align="left" valign="top">
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>
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>
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>
166
Sets the <a class="link" href="gnome-bluetooth-bluetooth-chooser.html#BluetoothChooser"><span class="type">BluetoothChooser</span></a>'s title.
168
<div class="variablelist"><table border="0">
169
<col align="left" valign="top">
172
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
173
<td>a BluetoothChooser widget.</td>
176
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
177
<td>the widget header title.</td>
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>
188
Returns the Bluetooth address for the currently selected device.
190
<div class="variablelist"><table border="0">
191
<col align="left" valign="top">
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>
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>
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>
212
Returns whether the <em class="parameter"><code>value</code></em> has been set.
214
<div class="variablelist"><table border="0">
215
<col align="left" valign="top">
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>
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>
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>
230
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></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>
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>
243
Returns the name for the currently selected device.
245
<div class="variablelist"><table border="0">
246
<col align="left" valign="top">
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>
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>
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>
265
Returns the icon name to use to represent the currently selected device.
267
<div class="variablelist"><table border="0">
268
<col align="left" valign="top">
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>
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>
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>
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.
289
<div class="variablelist"><table border="0">
290
<col align="left" valign="top">
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>
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>
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>
309
Returns whether the selected device is connected to this computer.
311
<div class="variablelist"><table border="0">
312
<col align="left" valign="top">
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>
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>
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>
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.
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>
338
<div class="variablelist"><table border="0">
339
<col align="left" valign="top">
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>
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>
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>.
353
<div class="variablelist"><table border="0">
354
<col align="left" valign="top">
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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.
453
<div class="variablelist"><table border="0">
454
<col align="left" valign="top">
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>
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>
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>
476
Generated by GTK-Doc V1.15.1</div>
b'\\ No newline at end of file'