• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • API Reference
  • Sitemap
  • Contact Us
 

libsolidcontrol

Solid::Control::BluetoothRemoteDevice

Solid::Control::BluetoothRemoteDevice Class Reference

#include <bluetoothremotedevice.h>

Inheritance diagram for Solid::Control::BluetoothRemoteDevice:

Inheritance graph
[legend]

List of all members.


Detailed Description

Represents a bluetooth remote device as seen by the bluetoothing subsystem.

Definition at line 42 of file bluetoothremotedevice.h.


Public Slots

void cancelBondingProcess ()
void clearAlias ()
void disconnect ()
void removeBonding ()
void serviceHandles (const QString &filter="") const
void serviceRecordAsXml (uint handle) const
void setAlias (const QString &alias)

Signals

void aliasChanged (const QString &alias)
void aliasCleared ()
void bondingCreated ()
void bondingRemoved ()
void classChanged (uint deviceClass)
void connected ()
void disconnected ()
void nameChanged (const QString &name)
void nameResolvingFailed ()
void requestDisconnection ()
void serviceHandlesAvailable (const QString &ubi, const QList< uint > &handles)
void serviceRecordXmlAvailable (const QString &ubi, const QString &record)

Public Member Functions

QString address () const
QString alias () const
 BluetoothRemoteDevice (const BluetoothRemoteDevice &device)
 BluetoothRemoteDevice (QObject *backendObject=0)
QString company () const
KJob * createBonding ()
int encryptionKeySize () const
bool hasBonding () const
bool isConnected () const
QString lastSeen () const
QString lastUsed () const
QString majorClass () const
QString manufacturer () const
QString minorClass () const
QString name () const
BluetoothRemoteDevice & operator= (const BluetoothRemoteDevice &device)
bool operator== (const BluetoothRemoteDevice &other) const
int pinCodeLength () const
QString revision () const
QStringList serviceClasses () const
QString ubi () const
QString version () const
 ~BluetoothRemoteDevice ()

Protected Attributes

BluetoothRemoteDevicePrivate * d_ptr

Constructor & Destructor Documentation

Solid::Control::BluetoothRemoteDevice::BluetoothRemoteDevice ( QObject *  backendObject = 0  ) 

Creates a new BluetoothRemoteDevice object.

Parameters:
backendObject the bluetooth remote device object provided by the backend

Definition at line 48 of file bluetoothremotedevice.cpp.

Solid::Control::BluetoothRemoteDevice::BluetoothRemoteDevice ( const BluetoothRemoteDevice &  device  ) 

Constructs a copy of a bluetooth remote device.

Parameters:
device the bluetooth remote device to copy

Definition at line 55 of file bluetoothremotedevice.cpp.

Solid::Control::BluetoothRemoteDevice::~BluetoothRemoteDevice (  ) 

Destroys the device.

Definition at line 62 of file bluetoothremotedevice.cpp.


Member Function Documentation

QString Solid::Control::BluetoothRemoteDevice::address (  )  const

Retrieves MAC address of the bluetooth remote device.

Returns:
MAC address of remote device.

Definition at line 84 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::alias (  )  const

Retrieves alias of remote device.

This is a local alias name for the remote device. If this string is empty the frontend should should use name(). This is handy if someone is using several bluetooth remote device with the same name. alias() should be preferred used by the frontend. Example: "Company mobile"

local alias of remote device.

Definition at line 143 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::aliasChanged ( const QString &  alias  )  [signal]

Alias has been changed of remote device.

alias the alias of the remote device

void Solid::Control::BluetoothRemoteDevice::aliasCleared (  )  [signal]

Alias got cleared of remote device.

void Solid::Control::BluetoothRemoteDevice::bondingCreated (  )  [signal]

Bonding with remote device has been created.

void Solid::Control::BluetoothRemoteDevice::bondingRemoved (  )  [signal]

Bonding has been removed of remote device.

void Solid::Control::BluetoothRemoteDevice::cancelBondingProcess (  )  [slot]

Cancel bonding process of remote device.

Definition at line 203 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::classChanged ( uint  deviceClass  )  [signal]

Class has been changed of remote device.

deviceClass the device class of the remote device

void Solid::Control::BluetoothRemoteDevice::clearAlias (  )  [slot]

Clear alias for remote device.

Definition at line 191 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::company (  )  const

Retrieves the manufacturer of the bluetooth chip of the remote device.

Returns:
company string of the bluetooth chip.

Definition at line 114 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::connected (  )  [signal]

Remote device has been connected.

KJob * Solid::Control::BluetoothRemoteDevice::createBonding (  ) 

Create bonding ("pairing") with remote device.

Returns:
the job handling of the operation.

Definition at line 179 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::disconnect (  )  [slot]

Disconnect remote device.

Definition at line 197 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::disconnected (  )  [signal]

Remote device has been disconnected.

int Solid::Control::BluetoothRemoteDevice::encryptionKeySize (  )  const

Retrieves currently used encryption key size of remote device.

Returns:
encryption key size.

Definition at line 173 of file bluetoothremotedevice.cpp.

bool Solid::Control::BluetoothRemoteDevice::hasBonding (  )  const

Retrieves true if remote device has bonding.

Returns:
true if remote device has bonding.

Definition at line 161 of file bluetoothremotedevice.cpp.

bool Solid::Control::BluetoothRemoteDevice::isConnected (  )  const

Retrieves true if remote device is connected.

Returns:
true if remote bluetooth device is connected otherwise false.

Definition at line 90 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::lastSeen (  )  const

Retrieves the date and time when the remote device has been seen.

Example: "2007-03-20 22:14:00 GMT"

Returns:
date and time when the remote device has been seen.

Definition at line 149 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::lastUsed (  )  const

Retrieves the date and time when the remote device has been used.

Example: "2007-03-20 22:14:00 GMT"

Returns:
date and time when the remote device has been used.

Definition at line 155 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::majorClass (  )  const

Retrieves the major class of the remote device.

Example: "computer"

Returns:
major class of remote device.

Definition at line 120 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::manufacturer (  )  const

Retrieves company name based on the device address.

Returns:
manufacturer string of bluetooth chip.

Definition at line 108 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::minorClass (  )  const

Retrieves the minor class of the remote device.

Exampe: "laptop"

Returns:
minor class of the remote device.

Definition at line 126 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::name (  )  const

Retrieves the real name of the remote device.

See also alias(). Example: "Daniel's mobile"

Returns:
name of remote device.

Definition at line 137 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::nameChanged ( const QString &  name  )  [signal]

Name has beend changed of remote device.

name the name of the remote device

void Solid::Control::BluetoothRemoteDevice::nameResolvingFailed (  )  [signal]

Resolving of remote device name failed.

Solid::Control::BluetoothRemoteDevice & Solid::Control::BluetoothRemoteDevice::operator= ( const BluetoothRemoteDevice &  device  ) 

Assigns a bluetooth remote device to this bluetooth remote device and returns a reference to it.

Parameters:
device the bluetooth remote device to assign
Returns:
a reference to the bluetooth remote device

Definition at line 65 of file bluetoothremotedevice.cpp.

bool Solid::Control::BluetoothRemoteDevice::operator== ( const BluetoothRemoteDevice &  other  )  const

Checks for equality.

Parameters:
other the bluetooth remote device to compare with this
Returns:
true if this->ubi() equals other.ubi(), false otherwise

Definition at line 73 of file bluetoothremotedevice.cpp.

int Solid::Control::BluetoothRemoteDevice::pinCodeLength (  )  const

Retrieves PIN code length that was used in the pairing process of remote device.

Returns:
PIN code length of pairing.

Definition at line 167 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::removeBonding (  )  [slot]

Remove bonding bonding of remote device.

Definition at line 209 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::requestDisconnection (  )  [signal]

Disconnection has been requested for remote device.

QString Solid::Control::BluetoothRemoteDevice::revision (  )  const

Retrieves the revision of the bluetooth chip of the remote device.

Returns:
revision of bluetooth chip.

Definition at line 102 of file bluetoothremotedevice.cpp.

QStringList Solid::Control::BluetoothRemoteDevice::serviceClasses (  )  const

Retrieves a list of service classes of the remote device.

Example: ["networking", "object transfer"]

Returns:
list of service classes of the remote device.

Definition at line 132 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::serviceHandles ( const QString &  filter = ""  )  const [slot]

Obtains a list of unique identifiers to each service provided by this remote device.

As this is a slow operation, this method only queues the message in the dbus and returns the list of handles using the serviceHandlesAvailable signal

NOTE: Most local adapters won't support more than one search at a time, so serialize your requests

Parameters:
filter A filter to apply to the search (look at http://wiki.bluez.org/wiki/HOWTO/DiscoveringServices#Searchpatterns)

Definition at line 214 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::serviceHandlesAvailable ( const QString &  ubi,
const QList< uint > &  handles 
) [signal]

Search for service handles is done.

void Solid::Control::BluetoothRemoteDevice::serviceRecordAsXml ( uint  handle  )  const [slot]

Requests the service record associated with the given handle.

As this is a slow operation, this method only queues the message in the dbus and returns the XML record using the serviceRecordXmlAvailable signal.

NOTE: Most local adapters won't support more than one search at a time, so serialize your requests

Parameters:
handle The handle that uniquely identifies the service record requested.

Definition at line 220 of file bluetoothremotedevice.cpp.

void Solid::Control::BluetoothRemoteDevice::serviceRecordXmlAvailable ( const QString &  ubi,
const QString &  record 
) [signal]

A new service record is available.

void Solid::Control::BluetoothRemoteDevice::setAlias ( const QString &  alias  )  [slot]

Set alias for remote device.

Parameters:
alias new alias name

Definition at line 185 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::ubi (  )  const

Retrieves the Universal Bluetooth Identifier (UBI) of the remote device.

This identifier is unique for each remote device and bluetooth interface in the system.

Returns:
the Universal Bluetooth Identifier of the current remote device.

Definition at line 78 of file bluetoothremotedevice.cpp.

QString Solid::Control::BluetoothRemoteDevice::version (  )  const

Retrieves the bluetooth version of the remote device.

LMP version (+ EDR support)

Returns:
version of bluetooth chip.

Definition at line 96 of file bluetoothremotedevice.cpp.


Member Data Documentation

BluetoothRemoteDevicePrivate* Solid::Control::BluetoothRemoteDevice::d_ptr [protected]

Definition at line 334 of file bluetoothremotedevice.h.


The documentation for this class was generated from the following files:
  • bluetoothremotedevice.h
  • bluetoothremotedevice.cpp

libsolidcontrol

Skip menu "libsolidcontrol"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

API Reference

Skip menu "API Reference"
  • KWin
  •   KWin Libraries
  • Libraries
  •   libkworkspace
  •   libplasma
  •   libsolidcontrol
  •   libtaskmanager
  • Plasma
  •   Animators
  •   Applets
  •   Engines
  • Solid Modules
Generated for API Reference by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal