1
<refentry id="BluetoothChooser">
3
<refentrytitle role="top_of_page" id="BluetoothChooser.top_of_page">BluetoothChooser</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GNOME-BLUETOOTH Library</refmiscinfo>
9
<refname>BluetoothChooser</refname>
10
<refpurpose></refpurpose>
13
<refsynopsisdiv id="BluetoothChooser.synopsis" role="synopsis">
14
<title role="synopsis.title">Synopsis</title>
17
#define <link linkend="BLUETOOTH-GET-CHOOSER-CLASS--CAPS">BLUETOOTH_GET_CHOOSER_CLASS</link> (obj)
18
<link linkend="BluetoothChooser-struct">BluetoothChooser</link>;
19
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="bluetooth-chooser-new">bluetooth_chooser_new</link> (const <link linkend="char">char</link> *title);
20
<link linkend="void">void</link> <link linkend="bluetooth-chooser-set-title">bluetooth_chooser_set_title</link> (<link linkend="BluetoothChooser">BluetoothChooser</link> *self,
21
const <link linkend="char">char</link> *title);
22
<link linkend="char">char</link> * <link linkend="bluetooth-chooser-get-selected-device">bluetooth_chooser_get_selected_device</link>
23
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
24
<link linkend="gboolean">gboolean</link> <link linkend="bluetooth-chooser-get-selected-device-info">bluetooth_chooser_get_selected_device_info</link>
25
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self,
26
const <link linkend="char">char</link> *field,
27
<link linkend="GValue">GValue</link> *value);
28
<link linkend="char">char</link> * <link linkend="bluetooth-chooser-get-selected-device-name">bluetooth_chooser_get_selected_device_name</link>
29
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
30
<link linkend="char">char</link> * <link linkend="bluetooth-chooser-get-selected-device-icon">bluetooth_chooser_get_selected_device_icon</link>
31
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
32
<link linkend="BluetoothType">BluetoothType</link> <link linkend="bluetooth-chooser-get-selected-device-type">bluetooth_chooser_get_selected_device_type</link>
33
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
34
<link linkend="gboolean">gboolean</link> <link linkend="bluetooth-chooser-get-selected-device-is-connected">bluetooth_chooser_get_selected_device_is_connected</link>
35
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
36
<link linkend="void">void</link> <link linkend="bluetooth-chooser-start-discovery">bluetooth_chooser_start_discovery</link> (<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
37
<link linkend="void">void</link> <link linkend="bluetooth-chooser-stop-discovery">bluetooth_chooser_stop_discovery</link> (<link linkend="BluetoothChooser">BluetoothChooser</link> *self);
41
<refsect1 id="BluetoothChooser.object-hierarchy" role="object_hierarchy">
42
<title role="object_hierarchy.title">Object Hierarchy</title>
44
<link linkend="GObject">GObject</link>
45
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
46
+----<link linkend="GtkObject">GtkObject</link>
47
+----<link linkend="GtkWidget">GtkWidget</link>
48
+----<link linkend="GtkContainer">GtkContainer</link>
49
+----<link linkend="GtkBox">GtkBox</link>
50
+----<link linkend="GtkVBox">GtkVBox</link>
57
<refsect1 id="BluetoothChooser.implemented-interfaces" role="impl_interfaces">
58
<title role="impl_interfaces.title">Implemented Interfaces</title>
60
BluetoothChooser implements
61
<link linkend="GtkBuildable">GtkBuildable</link>, <link linkend="AtkImplementorIface">AtkImplementorIface</link> and <link linkend="GtkOrientable">GtkOrientable</link>.</para>
65
<refsect1 id="BluetoothChooser.properties" role="properties">
66
<title role="properties.title">Properties</title>
68
"<link linkend="BluetoothChooser--device-category-filter">device-category-filter</link>" <link linkend="BluetoothCategory">BluetoothCategory</link> : Read / Write / Construct
69
"<link linkend="BluetoothChooser--device-selected">device-selected</link>" <link linkend="gchar">gchar</link>* : Read / Write
70
"<link linkend="BluetoothChooser--device-service-filter">device-service-filter</link>" <link linkend="gchar">gchar</link>* : Write
71
"<link linkend="BluetoothChooser--device-type-filter">device-type-filter</link>" <link linkend="gint">gint</link> : Read / Write / Construct
72
"<link linkend="BluetoothChooser--has-internal-device-filter">has-internal-device-filter</link>" <link linkend="gboolean">gboolean</link> : Read / Write / Construct Only
73
"<link linkend="BluetoothChooser--show-connected">show-connected</link>" <link linkend="gboolean">gboolean</link> : Read / Write
74
"<link linkend="BluetoothChooser--show-device-category">show-device-category</link>" <link linkend="gboolean">gboolean</link> : Read / Write / Construct
75
"<link linkend="BluetoothChooser--show-device-type">show-device-type</link>" <link linkend="gboolean">gboolean</link> : Read / Write / Construct
76
"<link linkend="BluetoothChooser--show-pairing">show-pairing</link>" <link linkend="gboolean">gboolean</link> : Read / Write
77
"<link linkend="BluetoothChooser--show-searching">show-searching</link>" <link linkend="gboolean">gboolean</link> : Read / Write
78
"<link linkend="BluetoothChooser--title">title</link>" <link linkend="gchar">gchar</link>* : Write
82
<refsect1 id="BluetoothChooser.signals" role="signal_proto">
83
<title role="signal_proto.title">Signals</title>
85
"<link linkend="BluetoothChooser-selected-device-changed">selected-device-changed</link>" : Run Last
90
<refsect1 id="BluetoothChooser.description" role="desc">
91
<title role="desc.title">Description</title>
96
<refsect1 id="BluetoothChooser.details" role="details">
97
<title role="details.title">Details</title>
98
<refsect2 id="BLUETOOTH-GET-CHOOSER-CLASS--CAPS" role="macro">
99
<title>BLUETOOTH_GET_CHOOSER_CLASS()</title>
100
<indexterm zone="BLUETOOTH-GET-CHOOSER-CLASS--CAPS"><primary sortas="BLUETOOTH_GET_CHOOSER_CLASS">BLUETOOTH_GET_CHOOSER_CLASS</primary></indexterm><programlisting>#define BLUETOOTH_GET_CHOOSER_CLASS(obj)</programlisting>
102
</para><variablelist role="params">
103
<varlistentry><term><parameter>obj</parameter> :</term>
105
</simpara></listitem></varlistentry>
106
</variablelist></refsect2>
107
<refsect2 id="BluetoothChooser-struct" role="struct">
108
<title>BluetoothChooser</title>
109
<indexterm zone="BluetoothChooser-struct"><primary sortas="BluetoothChooser">BluetoothChooser</primary></indexterm><programlisting>typedef struct _BluetoothChooser BluetoothChooser;</programlisting>
112
<refsect2 id="bluetooth-chooser-new" role="function">
113
<title>bluetooth_chooser_new ()</title>
114
<indexterm zone="bluetooth-chooser-new"><primary sortas="bluetooth_chooser_new">bluetooth_chooser_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * bluetooth_chooser_new (const <link linkend="char">char</link> *title);</programlisting>
118
</para><variablelist role="params">
119
<varlistentry><term><parameter>title</parameter> :</term>
120
<listitem><simpara> the widget header title, if <link linkend="NULL--CAPS"><literal>NULL</literal></link>, the widget header will be hidden.
121
</simpara></listitem></varlistentry>
122
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget
123
</simpara></listitem></varlistentry>
124
</variablelist></refsect2>
125
<refsect2 id="bluetooth-chooser-set-title" role="function">
126
<title>bluetooth_chooser_set_title ()</title>
127
<indexterm zone="bluetooth-chooser-set-title"><primary sortas="bluetooth_chooser_set_title">bluetooth_chooser_set_title</primary></indexterm><programlisting><link linkend="void">void</link> bluetooth_chooser_set_title (<link linkend="BluetoothChooser">BluetoothChooser</link> *self,
128
const <link linkend="char">char</link> *title);</programlisting>
130
Sets the <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link>'s title.</para>
132
</para><variablelist role="params">
133
<varlistentry><term><parameter>self</parameter> :</term>
134
<listitem><simpara> a BluetoothChooser widget.
135
</simpara></listitem></varlistentry>
136
<varlistentry><term><parameter>title</parameter> :</term>
137
<listitem><simpara> the widget header title.
138
</simpara></listitem></varlistentry>
139
</variablelist></refsect2>
140
<refsect2 id="bluetooth-chooser-get-selected-device" role="function">
141
<title>bluetooth_chooser_get_selected_device ()</title>
142
<indexterm zone="bluetooth-chooser-get-selected-device"><primary sortas="bluetooth_chooser_get_selected_device">bluetooth_chooser_get_selected_device</primary></indexterm><programlisting><link linkend="char">char</link> * bluetooth_chooser_get_selected_device
143
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
147
</para><variablelist role="params">
148
<varlistentry><term><parameter>self</parameter> :</term>
149
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
150
</simpara></listitem></varlistentry>
151
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the Bluetooth address for the currently selected device, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
152
</simpara></listitem></varlistentry>
153
</variablelist></refsect2>
154
<refsect2 id="bluetooth-chooser-get-selected-device-info" role="function">
155
<title>bluetooth_chooser_get_selected_device_info ()</title>
156
<indexterm zone="bluetooth-chooser-get-selected-device-info"><primary sortas="bluetooth_chooser_get_selected_device_info">bluetooth_chooser_get_selected_device_info</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> bluetooth_chooser_get_selected_device_info
157
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self,
158
const <link linkend="char">char</link> *field,
159
<link linkend="GValue">GValue</link> *value);</programlisting>
163
</para><variablelist role="params">
164
<varlistentry><term><parameter>self</parameter> :</term>
165
<listitem><simpara> A <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
166
</simpara></listitem></varlistentry>
167
<varlistentry><term><parameter>field</parameter> :</term>
168
<listitem><simpara> The identifier for the field to get data for.
169
</simpara></listitem></varlistentry>
170
<varlistentry><term><parameter>value</parameter> :</term>
171
<listitem><simpara> An empty <link linkend="GValue"><type>GValue</type></link> to set.
172
</simpara></listitem></varlistentry>
173
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <parameter>value</parameter> has been set.
174
</simpara></listitem></varlistentry>
175
</variablelist></refsect2>
176
<refsect2 id="bluetooth-chooser-get-selected-device-name" role="function">
177
<title>bluetooth_chooser_get_selected_device_name ()</title>
178
<indexterm zone="bluetooth-chooser-get-selected-device-name"><primary sortas="bluetooth_chooser_get_selected_device_name">bluetooth_chooser_get_selected_device_name</primary></indexterm><programlisting><link linkend="char">char</link> * bluetooth_chooser_get_selected_device_name
179
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
183
</para><variablelist role="params">
184
<varlistentry><term><parameter>self</parameter> :</term>
185
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
186
</simpara></listitem></varlistentry>
187
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the name for the currently selected device, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
188
</simpara></listitem></varlistentry>
189
</variablelist></refsect2>
190
<refsect2 id="bluetooth-chooser-get-selected-device-icon" role="function">
191
<title>bluetooth_chooser_get_selected_device_icon ()</title>
192
<indexterm zone="bluetooth-chooser-get-selected-device-icon"><primary sortas="bluetooth_chooser_get_selected_device_icon">bluetooth_chooser_get_selected_device_icon</primary></indexterm><programlisting><link linkend="char">char</link> * bluetooth_chooser_get_selected_device_icon
193
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
197
</para><variablelist role="params">
198
<varlistentry><term><parameter>self</parameter> :</term>
199
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
200
</simpara></listitem></varlistentry>
201
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the icon name to use to represent the currently selected device, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
202
</simpara></listitem></varlistentry>
203
</variablelist></refsect2>
204
<refsect2 id="bluetooth-chooser-get-selected-device-type" role="function">
205
<title>bluetooth_chooser_get_selected_device_type ()</title>
206
<indexterm zone="bluetooth-chooser-get-selected-device-type"><primary sortas="bluetooth_chooser_get_selected_device_type">bluetooth_chooser_get_selected_device_type</primary></indexterm><programlisting><link linkend="BluetoothType">BluetoothType</link> bluetooth_chooser_get_selected_device_type
207
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
211
</para><variablelist role="params">
212
<varlistentry><term><parameter>self</parameter> :</term>
213
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
214
</simpara></listitem></varlistentry>
215
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the <link linkend="BluetoothType"><type>BluetoothType</type></link> of the device selected, or '0' if unknown.
216
</simpara></listitem></varlistentry>
217
</variablelist></refsect2>
218
<refsect2 id="bluetooth-chooser-get-selected-device-is-connected" role="function">
219
<title>bluetooth_chooser_get_selected_device_is_connected ()</title>
220
<indexterm zone="bluetooth-chooser-get-selected-device-is-connected"><primary sortas="bluetooth_chooser_get_selected_device_is_connected">bluetooth_chooser_get_selected_device_is_connected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> bluetooth_chooser_get_selected_device_is_connected
221
(<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
225
</para><variablelist role="params">
226
<varlistentry><term><parameter>self</parameter> :</term>
227
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
228
</simpara></listitem></varlistentry>
229
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> whether the selected device is conncted to this computer,
230
will always be <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if no devices are selected.
231
</simpara></listitem></varlistentry>
232
</variablelist></refsect2>
233
<refsect2 id="bluetooth-chooser-start-discovery" role="function">
234
<title>bluetooth_chooser_start_discovery ()</title>
235
<indexterm zone="bluetooth-chooser-start-discovery"><primary sortas="bluetooth_chooser_start_discovery">bluetooth_chooser_start_discovery</primary></indexterm><programlisting><link linkend="void">void</link> bluetooth_chooser_start_discovery (<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
237
Starts a discovery on the default Bluetooth adapter. Note that this will
238
only work if the Search label is visible, as otherwise the user has no
239
visual feedback that the process is on-going.
242
See also: <link linkend="BluetoothChooser--show-searching"><type>"show-searching"</type></link></para>
244
</para><variablelist role="params">
245
<varlistentry><term><parameter>self</parameter> :</term>
246
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
247
</simpara></listitem></varlistentry>
248
</variablelist></refsect2>
249
<refsect2 id="bluetooth-chooser-stop-discovery" role="function">
250
<title>bluetooth_chooser_stop_discovery ()</title>
251
<indexterm zone="bluetooth-chooser-stop-discovery"><primary sortas="bluetooth_chooser_stop_discovery">bluetooth_chooser_stop_discovery</primary></indexterm><programlisting><link linkend="void">void</link> bluetooth_chooser_stop_discovery (<link linkend="BluetoothChooser">BluetoothChooser</link> *self);</programlisting>
253
Stops a discovery started with <link linkend="bluetooth-chooser-start-discovery"><type>bluetooth_chooser_start_discovery</type></link>.</para>
255
</para><variablelist role="params">
256
<varlistentry><term><parameter>self</parameter> :</term>
257
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
258
</simpara></listitem></varlistentry>
259
</variablelist></refsect2>
262
<refsect1 id="BluetoothChooser.property-details" role="property_details">
263
<title role="property_details.title">Property Details</title>
264
<refsect2 id="BluetoothChooser--device-category-filter" role="property"><title>The <literal>"device-category-filter"</literal> property</title>
265
<indexterm zone="BluetoothChooser--device-category-filter"><primary sortas="BluetoothChooser:device-category-filter">BluetoothChooser:device-category-filter</primary></indexterm><programlisting> "device-category-filter" <link linkend="BluetoothCategory">BluetoothCategory</link> : Read / Write / Construct</programlisting>
266
<para>The #BluetoothCategory to show.</para><para>Default value: BLUETOOTH_CATEGORY_ALL</para>
268
<refsect2 id="BluetoothChooser--device-selected" role="property"><title>The <literal>"device-selected"</literal> property</title>
269
<indexterm zone="BluetoothChooser--device-selected"><primary sortas="BluetoothChooser:device-selected">BluetoothChooser:device-selected</primary></indexterm><programlisting> "device-selected" <link linkend="gchar">gchar</link>* : Read / Write</programlisting>
270
<para>the Bluetooth address for the currently selected device, or %NULL.</para><para>Default value: NULL</para>
272
<refsect2 id="BluetoothChooser--device-service-filter" role="property"><title>The <literal>"device-service-filter"</literal> property</title>
273
<indexterm zone="BluetoothChooser--device-service-filter"><primary sortas="BluetoothChooser:device-service-filter">BluetoothChooser:device-service-filter</primary></indexterm><programlisting> "device-service-filter" <link linkend="gchar">gchar</link>* : Write</programlisting>
274
<para>A string representing the service to filter for.</para><para>Default value: NULL</para>
276
<refsect2 id="BluetoothChooser--device-type-filter" role="property"><title>The <literal>"device-type-filter"</literal> property</title>
277
<indexterm zone="BluetoothChooser--device-type-filter"><primary sortas="BluetoothChooser:device-type-filter">BluetoothChooser:device-type-filter</primary></indexterm><programlisting> "device-type-filter" <link linkend="gint">gint</link> : Read / Write / Construct</programlisting>
278
<para>A bitmask of #BluetoothType to show.</para><para>Allowed values: [1,16383]</para>
279
<para>Default value: 1</para>
281
<refsect2 id="BluetoothChooser--has-internal-device-filter" role="property"><title>The <literal>"has-internal-device-filter"</literal> property</title>
282
<indexterm zone="BluetoothChooser--has-internal-device-filter"><primary sortas="BluetoothChooser:has-internal-device-filter">BluetoothChooser:has-internal-device-filter</primary></indexterm><programlisting> "has-internal-device-filter" <link linkend="gboolean">gboolean</link> : Read / Write / Construct Only</programlisting>
283
<para>Whether the #BluetoothChooser should be constructed with a visible #BluetoothFilterWidget.</para><para>Default value: TRUE</para>
285
<refsect2 id="BluetoothChooser--show-connected" role="property"><title>The <literal>"show-connected"</literal> property</title>
286
<indexterm zone="BluetoothChooser--show-connected"><primary sortas="BluetoothChooser:show-connected">BluetoothChooser:show-connected</primary></indexterm><programlisting> "show-connected" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
287
<para>Whether to show the connected column in the tree.</para><para>Default value: FALSE</para>
289
<refsect2 id="BluetoothChooser--show-device-category" role="property"><title>The <literal>"show-device-category"</literal> property</title>
290
<indexterm zone="BluetoothChooser--show-device-category"><primary sortas="BluetoothChooser:show-device-category">BluetoothChooser:show-device-category</primary></indexterm><programlisting> "show-device-category" <link linkend="gboolean">gboolean</link> : Read / Write / Construct</programlisting>
291
<para>Whether to show the device category filter.</para><para>Default value: TRUE</para>
293
<refsect2 id="BluetoothChooser--show-device-type" role="property"><title>The <literal>"show-device-type"</literal> property</title>
294
<indexterm zone="BluetoothChooser--show-device-type"><primary sortas="BluetoothChooser:show-device-type">BluetoothChooser:show-device-type</primary></indexterm><programlisting> "show-device-type" <link linkend="gboolean">gboolean</link> : Read / Write / Construct</programlisting>
295
<para>Whether to show the device type filter.</para><para>Default value: TRUE</para>
297
<refsect2 id="BluetoothChooser--show-pairing" role="property"><title>The <literal>"show-pairing"</literal> property</title>
298
<indexterm zone="BluetoothChooser--show-pairing"><primary sortas="BluetoothChooser:show-pairing">BluetoothChooser:show-pairing</primary></indexterm><programlisting> "show-pairing" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
299
<para>Whether to show the pairing column in the tree.</para><para>Default value: FALSE</para>
301
<refsect2 id="BluetoothChooser--show-searching" role="property"><title>The <literal>"show-searching"</literal> property</title>
302
<indexterm zone="BluetoothChooser--show-searching"><primary sortas="BluetoothChooser:show-searching">BluetoothChooser:show-searching</primary></indexterm><programlisting> "show-searching" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
303
<para>Whether to show the Searching label , this is necessary if you want to programmatically start a discovery, using bluetooth_chooser_start_discovery().</para><para>Default value: FALSE</para>
305
<refsect2 id="BluetoothChooser--title" role="property"><title>The <literal>"title"</literal> property</title>
306
<indexterm zone="BluetoothChooser--title"><primary sortas="BluetoothChooser:title">BluetoothChooser:title</primary></indexterm><programlisting> "title" <link linkend="gchar">gchar</link>* : Write</programlisting>
307
<para>The widget header title.</para><para>Default value: NULL</para>
311
<refsect1 id="BluetoothChooser.signal-details" role="signals">
312
<title role="signals.title">Signal Details</title>
313
<refsect2 id="BluetoothChooser-selected-device-changed" role="signal"><title>The <literal>"selected-device-changed"</literal> signal</title>
314
<indexterm zone="BluetoothChooser-selected-device-changed"><primary sortas="BluetoothChooser::selected-device-changed">BluetoothChooser::selected-device-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="BluetoothChooser">BluetoothChooser</link> *chooser,
315
<link linkend="gchar">gchar</link> *address,
316
<link linkend="gpointer">gpointer</link> user_data) : Run Last</programlisting>
318
The <link linkend="BluetoothChooser--selected-device-changed"><type>"selected-device-changed"</type></link> signal is launched when the
319
selected device is changed, it will be <link linkend="NULL--CAPS"><literal>NULL</literal></link> if a device was unselected.</para>
321
</para><variablelist role="params">
322
<varlistentry><term><parameter>chooser</parameter> :</term>
323
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget which received the signal
324
</simpara></listitem></varlistentry>
325
<varlistentry><term><parameter>address</parameter> :</term>
326
<listitem><simpara> the Bluetooth address for the currently selected device, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
327
</simpara></listitem></varlistentry>
328
<varlistentry><term><parameter>user_data</parameter> :</term>
329
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
330
</variablelist></refsect2>