Home · All Classes · Grouped Classes · Annotated · Functions

QBluetoothServiceController Class Reference

The QBluetoothServiceController class provides a means to control and access information for Qtopia Bluetooth services. More...

    #include <QBluetoothServiceController>

Inherits QObject.

Public Types

Public Functions

Signals

Additional Inherited Members


Detailed Description

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

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

Qtopia has a number of built-in Bluetooth services, as found in Qtopia's Bluetooth settings application. Any of these services can be controlled through an instance of QBluetoothServiceController. You can also create your own Qtopia 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().

ConstantValueDescription
QBluetoothServiceController::NotRunning0The service is not running.
QBluetoothServiceController::Starting1The service is starting.
QBluetoothServiceController::Running2The service is running.


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().


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3