Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

SettingsService Class Reference

The SettingsService class provides the Settings service. More...

    #include <SettingsService>

Inherits QtopiaAbstractService.

• List of all members, including inherited members

Public Slots

• void activateDefault ()
• void activateSettings ( const QString & details )
• void pullSettingStatus ()
• void setStatus ( const QString & details )

• 1 public slot inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 29 public functions inherited from QObject
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 1 protected function inherited from QtopiaAbstractService
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The SettingsService class provides the Settings service.

The Settings service is implemented by settings applications, to allow them to integrate with the Qt Extended settings manager.

See also SettingsManagerService.

Member Function Documentation

void SettingsService::activateDefault ()   [slot]

Activate the default settings for this application. This is sent from the settings manager when a settings override value is deleted.

This slot corresponds to the QCop service message Settings::activateDefault().

void SettingsService::activateSettings ( const QString & details )   [slot]

Make details the active settings for this application. This is sent from the settings manager when the settings profile is changed.

This slot corresponds to the QCop service message Settings::activateSettings(QString).

void SettingsService::pullSettingStatus ()   [slot]

Pull the settings status for this application and send it to the settings manager. The settings application should respond to this message as follows:

    QtopiaServiceRequest req
        ( "SettingsManager", "pullSettingStatus(QString,QString,QString)" );
    req << appName;
    req << windowTitle;
    req << details;
    req.send();

where appName is the name of the application (e.g. appearance), windowTitle is the title on the window to indicate to the user what kind of settings are being sent, and details is an opaque string that can be later sent to activateSettings().

The settings application can also send its current settings whenever it likes by explicitly pushing the setting values to the settings manager as follows:

    QtopiaServiceRequest req
        ( "SettingsManager", "pushSettingStatus(QString,QString,QString)" );
    req << appName;
    req << windowTitle;
    req << details;
    req.send();

This slot corresponds to the QCop service message Settings::pullSettingStatus().

See also SettingsManagerService.

void SettingsService::setStatus ( const QString & details )   [slot]

Set the status details for this settings application. This is sent from the settings manager when the user selects a particular setting for viewing or editing.

This slot corresponds to the QCop service message Settings::setStatus(QString).