SettingsService Class Reference

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