![]() |
![]() |
![]() |
gnome-bluetooth Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
#define BLUETOOTH_GET_CHOOSER_CLASS (obj) BluetoothChooser; GtkWidget * bluetooth_chooser_new (const char *title); void bluetooth_chooser_set_title (BluetoothChooser *self, const char *title); char * bluetooth_chooser_get_selected_device (BluetoothChooser *self); gboolean bluetooth_chooser_get_selected_device_info (BluetoothChooser *self, const char *field, GValue *value); char * bluetooth_chooser_get_selected_device_name (BluetoothChooser *self); char * bluetooth_chooser_get_selected_device_icon (BluetoothChooser *self); BluetoothType bluetooth_chooser_get_selected_device_type (BluetoothChooser *self); gboolean bluetooth_chooser_get_selected_device_is_connected (BluetoothChooser *self); void bluetooth_chooser_start_discovery (BluetoothChooser *self); void bluetooth_chooser_stop_discovery (BluetoothChooser *self);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----BluetoothChooser
BluetoothChooser implements GtkBuildable, AtkImplementorIface and GtkOrientable.
"device-category-filter" BluetoothCategory : Read / Write "device-selected" gchar* : Read "device-service-filter" gchar* : Write "device-type-filter" gint : Read / Write "show-connected" gboolean : Read / Write "show-device-category" gboolean : Read / Write "show-device-type" gboolean : Read / Write "show-pairing" gboolean : Read / Write "show-searching" gboolean : Read / Write "title" gchar* : Write
GtkWidget * bluetooth_chooser_new (const char *title);
|
the widget header title, if NULL , the widget header will be hidden.
|
Returns : |
A BluetoothChooser widget |
void bluetooth_chooser_set_title (BluetoothChooser *self, const char *title);
|
a BluetoothChooser widget. |
|
the widget header title. |
char * bluetooth_chooser_get_selected_device (BluetoothChooser *self);
|
a BluetoothChooser widget. |
Returns : |
the Bluetooth address for the currently selected device, or NULL .
|
gboolean bluetooth_chooser_get_selected_device_info (BluetoothChooser *self, const char *field, GValue *value);
|
A BluetoothChooser widget. |
|
The identifier for the field to get data for. |
|
An empty GValue to set. |
Returns : |
TRUE if the value has been set.
|
char * bluetooth_chooser_get_selected_device_name (BluetoothChooser *self);
|
a BluetoothChooser widget. |
Returns : |
the name for the currently selected device, or NULL .
|
char * bluetooth_chooser_get_selected_device_icon (BluetoothChooser *self);
|
a BluetoothChooser widget. |
Returns : |
the icon name to use to represent the currently selected device, or NULL .
|
BluetoothType bluetooth_chooser_get_selected_device_type (BluetoothChooser *self);
|
a BluetoothChooser widget. |
Returns : |
the BluetoothType of the device selected, or '0' if unknown. |
gboolean bluetooth_chooser_get_selected_device_is_connected (BluetoothChooser *self);
|
a BluetoothChooser widget. |
Returns : |
whether the selected device is conncted to this computer,
will always be FALSE if no devices are selected.
|
void bluetooth_chooser_start_discovery (BluetoothChooser *self);
Starts a discovery on the default Bluetooth adapter. Note that this will only work if the Search label is visible, as otherwise the user has no visual feedback that the process is on-going.
See also: "show-searching"
|
a BluetoothChooser widget. |
void bluetooth_chooser_stop_discovery (BluetoothChooser *self);
Stops a discovery started with bluetooth_chooser_start_discovery.
|
a BluetoothChooser widget. |
"device-category-filter"
property"device-category-filter" BluetoothCategory : Read / Write
The #BluetoothCategory to show.
Default value: BLUETOOTH_CATEGORY_ALL
"device-selected"
property"device-selected" gchar* : Read
the Bluetooth address for the currently selected device, or %NULL.
Default value: NULL
"device-service-filter"
property"device-service-filter" gchar* : Write
A string representing the service to filter for.
Default value: NULL
"device-type-filter"
property"device-type-filter" gint : Read / Write
A bitmask of #BluetoothType to show.
Allowed values: [1,16383]
Default value: 1
"show-connected"
property"show-connected" gboolean : Read / Write
Whether to show the connected column in the tree.
Default value: FALSE
"show-device-category"
property"show-device-category" gboolean : Read / Write
Whether to show the device category filter.
Default value: TRUE
"show-device-type"
property"show-device-type" gboolean : Read / Write
Whether to show the device type filter.
Default value: TRUE
"show-pairing"
property"show-pairing" gboolean : Read / Write
Whether to show the pairing column in the tree.
Default value: FALSE
"show-searching"
property"show-searching" gboolean : Read / Write
Whether to show the Searching label , this is necessary if you want to programmatically start a discovery, using bluetooth_chooser_start_discovery().
Default value: FALSE
"selected-device-changed"
signalvoid user_function (BluetoothChooser *arg0, gchar *arg1, gpointer user_data) : Run Last
chooser
: a BluetoothChooser widget which received the signal
address
: the Bluetooth address for the currently selected device, or NULL
The "selected-device-changed" signal is launched when the
selected device is changed, it will be NULL
if a device was unselected.
|
user data set when the signal handler was connected. |