QBluetoothServiceController Class Reference
[QtBluetoothModule]

Detailed Description

The QBluetoothServiceController class provides a means to control and access information for Qt Extended Bluetooth services.

This class allows the programmer to start and stop Qt Extended Bluetooth services, set their security options, and view a service's attributes, such as its state, name and security options.

Qt Extended has a number of built-in Bluetooth services, as found in the Bluetooth settings application. Any of these services can be controlled through an instance of QBluetoothServiceController. You can also create your own Qt Extended Bluetooth services that will be controllable through this interface; simply subclass QBluetoothAbstractService. (See the QBluetoothAbstractService class documentation for more details.)

Member Type Documentation

enum QBluetoothServiceController::ServiceState

Defines the possible states for a service which may be returned from state().

Member Function Documentation

QBluetoothServiceController::QBluetoothServiceController ( QObject * parent = 0 )

Constructs a QBluetoothServiceController with parent object parent.

QBluetoothServiceController::~QBluetoothServiceController ()

Destroys a QBluetoothServiceController.

QString QBluetoothServiceController::displayName ( const QString & name ) const

Returns the user-friendly, internationalized display name for the service named name.

QBluetooth::SecurityOptions QBluetoothServiceController::securityOptions ( const QString & name ) const

Returns the security options for the service named name.

See also setSecurityOptions().

QStringList QBluetoothServiceController::services () const

Returns a list of the names of all known Bluetooth services within Qtopia.

void QBluetoothServiceController::setSecurityOptions ( const QString & name, QBluetooth::SecurityOptions options )

Sets the security options for the service with name name to the given options.

See also securityOptions().

void QBluetoothServiceController::start ( const QString & name )

Starts the service named name.

The started() signal will be emitted when the service has started.

See also stop().

void QBluetoothServiceController::started ( const QString & name, bool error, const QString & description )   [signal]

This signal is emitted when the service named name has started or failed while attempting to start. If there was a failure, error is true and description provides the human-readable error description.

See also start() and stopped().

QBluetoothServiceController::ServiceState QBluetoothServiceController::state ( const QString & name ) const

Returns the state of the service named name.

See also stopped() and started().

void QBluetoothServiceController::stop ( const QString & name )

Stops the service named name.

The stopped() signal will be emitted when the service has stopped.

See also start().

void QBluetoothServiceController::stopped ( const QString & name )   [signal]

This signal is emitted when the service named name has stopped.

See also stop() and started().