MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QSensorManager Class Reference

The QSensorManager class handles registration and creation of sensor backends. More...

 #include <QSensorManager>

This class was introduced in Qt Mobility 1.0.

Static Public Members

QSensorBackend * createBackend ( QSensor * sensor )
bool isBackendRegistered ( const QByteArray & type, const QByteArray & identifier )
void registerBackend ( const QByteArray & type, const QByteArray & identifier, QSensorBackendFactory * factory )
void unregisterBackend ( const QByteArray & type, const QByteArray & identifier )

Macros

REGISTER_STATIC_PLUGIN ( pluginname )

Detailed Description

The QSensorManager class handles registration and creation of sensor backends.

Sensor plugins register backends using the registerBackend() function.

When QSensor::connectToBackend() is called, the createBackend() function will be called.

Member Function Documentation

QSensorBackend * QSensorManager::createBackend ( QSensor * sensor ) [static]

Create a backend for sensor. Returns null if no suitable backend exists.

This function was introduced in Qt Mobility 1.0.

bool QSensorManager::isBackendRegistered ( const QByteArray & type, const QByteArray & identifier ) [static]

Returns true if the backend identified by type and identifier is registered.

This is a convenience method that helps out plugins doing dynamic registration.

This function was introduced in Qt Mobility 1.2.

void QSensorManager::registerBackend ( const QByteArray & type, const QByteArray & identifier, QSensorBackendFactory * factory ) [static]

Register a sensor for type. The identifier must be unique.

The factory will be asked to create instances of the backend.

This function was introduced in Qt Mobility 1.0.

void QSensorManager::unregisterBackend ( const QByteArray & type, const QByteArray & identifier ) [static]

Unregister the backend for type with identifier.

Note that this only prevents new instance of the backend from being created. It does not invalidate the existing instances of the backend. The backend code should handle the disappearance of the underlying hardware itself.

This function was introduced in Qt Mobility 1.2.

Macro Documentation

REGISTER_STATIC_PLUGIN ( pluginname )

Registers a static plugin, pluginname.

Note that this macro relies on static initialization so it may not be appropriate for use in a library and may not work on all platforms.

See also Creating a sensor plugin.