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

« back to all changes in this revision

Viewing changes to docs/reference/libgnome-bluetooth/xml/bluetooth-chooser.xml

  • 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
 
<refentry id="BluetoothChooser">
2
 
<refmeta>
3
 
<refentrytitle role="top_of_page" id="BluetoothChooser.top_of_page">BluetoothChooser</refentrytitle>
4
 
<manvolnum>3</manvolnum>
5
 
<refmiscinfo>GNOME-BLUETOOTH Library</refmiscinfo>
6
 
</refmeta>
7
 
 
8
 
<refnamediv>
9
 
<refname>BluetoothChooser</refname>
10
 
<refpurpose></refpurpose>
11
 
</refnamediv>
12
 
 
13
 
<refsynopsisdiv id="BluetoothChooser.synopsis" role="synopsis">
14
 
<title role="synopsis.title">Synopsis</title>
15
 
 
16
 
<synopsis>
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);
38
 
</synopsis>
39
 
</refsynopsisdiv>
40
 
 
41
 
<refsect1 id="BluetoothChooser.object-hierarchy" role="object_hierarchy">
42
 
<title role="object_hierarchy.title">Object Hierarchy</title>
43
 
<synopsis>
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>
51
 
                                       +----BluetoothChooser
52
 
</synopsis>
53
 
</refsect1>
54
 
 
55
 
 
56
 
 
57
 
<refsect1 id="BluetoothChooser.implemented-interfaces" role="impl_interfaces">
58
 
<title role="impl_interfaces.title">Implemented Interfaces</title>
59
 
<para>
60
 
BluetoothChooser implements
61
 
 <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>
62
 
</refsect1>
63
 
 
64
 
 
65
 
<refsect1 id="BluetoothChooser.properties" role="properties">
66
 
<title role="properties.title">Properties</title>
67
 
<synopsis>
68
 
  &quot;<link linkend="BluetoothChooser--device-category-filter">device-category-filter</link>&quot;   <link linkend="BluetoothCategory">BluetoothCategory</link>     : Read / Write / Construct
69
 
  &quot;<link linkend="BluetoothChooser--device-selected">device-selected</link>&quot;          <link linkend="gchar">gchar</link>*                : Read / Write
70
 
  &quot;<link linkend="BluetoothChooser--device-service-filter">device-service-filter</link>&quot;    <link linkend="gchar">gchar</link>*                : Write
71
 
  &quot;<link linkend="BluetoothChooser--device-type-filter">device-type-filter</link>&quot;       <link linkend="gint">gint</link>                  : Read / Write / Construct
72
 
  &quot;<link linkend="BluetoothChooser--has-internal-device-filter">has-internal-device-filter</link>&quot; <link linkend="gboolean">gboolean</link>              : Read / Write / Construct Only
73
 
  &quot;<link linkend="BluetoothChooser--show-connected">show-connected</link>&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write
74
 
  &quot;<link linkend="BluetoothChooser--show-device-category">show-device-category</link>&quot;     <link linkend="gboolean">gboolean</link>              : Read / Write / Construct
75
 
  &quot;<link linkend="BluetoothChooser--show-device-type">show-device-type</link>&quot;         <link linkend="gboolean">gboolean</link>              : Read / Write / Construct
76
 
  &quot;<link linkend="BluetoothChooser--show-pairing">show-pairing</link>&quot;             <link linkend="gboolean">gboolean</link>              : Read / Write
77
 
  &quot;<link linkend="BluetoothChooser--show-searching">show-searching</link>&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write
78
 
  &quot;<link linkend="BluetoothChooser--title">title</link>&quot;                    <link linkend="gchar">gchar</link>*                : Write
79
 
</synopsis>
80
 
</refsect1>
81
 
 
82
 
<refsect1 id="BluetoothChooser.signals" role="signal_proto">
83
 
<title role="signal_proto.title">Signals</title>
84
 
<synopsis>
85
 
  &quot;<link linkend="BluetoothChooser-selected-device-changed">selected-device-changed</link>&quot;                        : Run Last
86
 
</synopsis>
87
 
</refsect1>
88
 
 
89
 
 
90
 
<refsect1 id="BluetoothChooser.description" role="desc">
91
 
<title role="desc.title">Description</title>
92
 
<para>
93
 
</para>
94
 
</refsect1>
95
 
 
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>
101
 
<para>
102
 
</para><variablelist role="params">
103
 
<varlistentry><term><parameter>obj</parameter>&#160;:</term>
104
 
<listitem><simpara>
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>
110
 
<para>
111
 
</para></refsect2>
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>
115
 
<para>
116
 
</para>
117
 
<para>
118
 
</para><variablelist role="params">
119
 
<varlistentry><term><parameter>title</parameter>&#160;:</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>&#160;:</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>
129
 
<para>
130
 
Sets the <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link>'s title.</para>
131
 
<para>
132
 
</para><variablelist role="params">
133
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
134
 
<listitem><simpara> a BluetoothChooser widget.
135
 
</simpara></listitem></varlistentry>
136
 
<varlistentry><term><parameter>title</parameter>&#160;:</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>
144
 
<para>
145
 
</para>
146
 
<para>
147
 
</para><variablelist role="params">
148
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
149
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
150
 
</simpara></listitem></varlistentry>
151
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</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>
160
 
<para>
161
 
</para>
162
 
<para>
163
 
</para><variablelist role="params">
164
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
165
 
<listitem><simpara> A <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
166
 
</simpara></listitem></varlistentry>
167
 
<varlistentry><term><parameter>field</parameter>&#160;:</term>
168
 
<listitem><simpara> The identifier for the field to get data for.
169
 
</simpara></listitem></varlistentry>
170
 
<varlistentry><term><parameter>value</parameter>&#160;:</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>&#160;:</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>
180
 
<para>
181
 
</para>
182
 
<para>
183
 
</para><variablelist role="params">
184
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
185
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
186
 
</simpara></listitem></varlistentry>
187
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</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>
194
 
<para>
195
 
</para>
196
 
<para>
197
 
</para><variablelist role="params">
198
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
199
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
200
 
</simpara></listitem></varlistentry>
201
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</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>
208
 
<para>
209
 
</para>
210
 
<para>
211
 
</para><variablelist role="params">
212
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
213
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
214
 
</simpara></listitem></varlistentry>
215
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</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>
222
 
<para>
223
 
</para>
224
 
<para>
225
 
</para><variablelist role="params">
226
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
227
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
228
 
</simpara></listitem></varlistentry>
229
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</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>
236
 
<para>
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.
240
 
</para>
241
 
<para>
242
 
See also: <link linkend="BluetoothChooser--show-searching"><type>"show-searching"</type></link></para>
243
 
<para>
244
 
</para><variablelist role="params">
245
 
<varlistentry><term><parameter>self</parameter>&#160;:</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>
252
 
<para>
253
 
Stops a discovery started with <link linkend="bluetooth-chooser-start-discovery"><type>bluetooth_chooser_start_discovery</type></link>.</para>
254
 
<para>
255
 
</para><variablelist role="params">
256
 
<varlistentry><term><parameter>self</parameter>&#160;:</term>
257
 
<listitem><simpara> a <link linkend="BluetoothChooser"><type>BluetoothChooser</type></link> widget.
258
 
</simpara></listitem></varlistentry>
259
 
</variablelist></refsect2>
260
 
 
261
 
</refsect1>
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>&quot;device-category-filter&quot;</literal> property</title>
265
 
<indexterm zone="BluetoothChooser--device-category-filter"><primary sortas="BluetoothChooser:device-category-filter">BluetoothChooser:device-category-filter</primary></indexterm><programlisting>  &quot;device-category-filter&quot;   <link linkend="BluetoothCategory">BluetoothCategory</link>     : Read / Write / Construct</programlisting>
266
 
<para>The #BluetoothCategory to show.</para><para>Default value: BLUETOOTH_CATEGORY_ALL</para>
267
 
</refsect2>
268
 
<refsect2 id="BluetoothChooser--device-selected" role="property"><title>The <literal>&quot;device-selected&quot;</literal> property</title>
269
 
<indexterm zone="BluetoothChooser--device-selected"><primary sortas="BluetoothChooser:device-selected">BluetoothChooser:device-selected</primary></indexterm><programlisting>  &quot;device-selected&quot;          <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>
271
 
</refsect2>
272
 
<refsect2 id="BluetoothChooser--device-service-filter" role="property"><title>The <literal>&quot;device-service-filter&quot;</literal> property</title>
273
 
<indexterm zone="BluetoothChooser--device-service-filter"><primary sortas="BluetoothChooser:device-service-filter">BluetoothChooser:device-service-filter</primary></indexterm><programlisting>  &quot;device-service-filter&quot;    <link linkend="gchar">gchar</link>*                : Write</programlisting>
274
 
<para>A string representing the service to filter for.</para><para>Default value: NULL</para>
275
 
</refsect2>
276
 
<refsect2 id="BluetoothChooser--device-type-filter" role="property"><title>The <literal>&quot;device-type-filter&quot;</literal> property</title>
277
 
<indexterm zone="BluetoothChooser--device-type-filter"><primary sortas="BluetoothChooser:device-type-filter">BluetoothChooser:device-type-filter</primary></indexterm><programlisting>  &quot;device-type-filter&quot;       <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>
280
 
</refsect2>
281
 
<refsect2 id="BluetoothChooser--has-internal-device-filter" role="property"><title>The <literal>&quot;has-internal-device-filter&quot;</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>  &quot;has-internal-device-filter&quot; <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>
284
 
</refsect2>
285
 
<refsect2 id="BluetoothChooser--show-connected" role="property"><title>The <literal>&quot;show-connected&quot;</literal> property</title>
286
 
<indexterm zone="BluetoothChooser--show-connected"><primary sortas="BluetoothChooser:show-connected">BluetoothChooser:show-connected</primary></indexterm><programlisting>  &quot;show-connected&quot;           <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>
288
 
</refsect2>
289
 
<refsect2 id="BluetoothChooser--show-device-category" role="property"><title>The <literal>&quot;show-device-category&quot;</literal> property</title>
290
 
<indexterm zone="BluetoothChooser--show-device-category"><primary sortas="BluetoothChooser:show-device-category">BluetoothChooser:show-device-category</primary></indexterm><programlisting>  &quot;show-device-category&quot;     <link linkend="gboolean">gboolean</link>              : Read / Write / Construct</programlisting>
291
 
<para>Whether to show the device category filter.</para><para>Default value: TRUE</para>
292
 
</refsect2>
293
 
<refsect2 id="BluetoothChooser--show-device-type" role="property"><title>The <literal>&quot;show-device-type&quot;</literal> property</title>
294
 
<indexterm zone="BluetoothChooser--show-device-type"><primary sortas="BluetoothChooser:show-device-type">BluetoothChooser:show-device-type</primary></indexterm><programlisting>  &quot;show-device-type&quot;         <link linkend="gboolean">gboolean</link>              : Read / Write / Construct</programlisting>
295
 
<para>Whether to show the device type filter.</para><para>Default value: TRUE</para>
296
 
</refsect2>
297
 
<refsect2 id="BluetoothChooser--show-pairing" role="property"><title>The <literal>&quot;show-pairing&quot;</literal> property</title>
298
 
<indexterm zone="BluetoothChooser--show-pairing"><primary sortas="BluetoothChooser:show-pairing">BluetoothChooser:show-pairing</primary></indexterm><programlisting>  &quot;show-pairing&quot;             <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>
300
 
</refsect2>
301
 
<refsect2 id="BluetoothChooser--show-searching" role="property"><title>The <literal>&quot;show-searching&quot;</literal> property</title>
302
 
<indexterm zone="BluetoothChooser--show-searching"><primary sortas="BluetoothChooser:show-searching">BluetoothChooser:show-searching</primary></indexterm><programlisting>  &quot;show-searching&quot;           <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>
304
 
</refsect2>
305
 
<refsect2 id="BluetoothChooser--title" role="property"><title>The <literal>&quot;title&quot;</literal> property</title>
306
 
<indexterm zone="BluetoothChooser--title"><primary sortas="BluetoothChooser:title">BluetoothChooser:title</primary></indexterm><programlisting>  &quot;title&quot;                    <link linkend="gchar">gchar</link>*                : Write</programlisting>
307
 
<para>The widget header title.</para><para>Default value: NULL</para>
308
 
</refsect2>
309
 
</refsect1>
310
 
 
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>&quot;selected-device-changed&quot;</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>
317
 
<para>
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>
320
 
<para>
321
 
</para><variablelist role="params">
322
 
<varlistentry><term><parameter>chooser</parameter>&#160;:</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>&#160;:</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>&#160;:</term>
329
 
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
330
 
</variablelist></refsect2>
331
 
</refsect1>
332
 
 
333
 
 
334
 
 
335
 
</refentry>