Inhibiting the device screen saver using Qt

Article Metadata

---

Tested with

Devices(s): Nokia E7-00, N8-00, N900

---

Compatibility

Platform(s): Symbian
Maemo

---

Article

Keywords: QSystemScreenSaver

Created: kratsan (27 Jan 2011)

Last edited: hamishwillee (11 Oct 2012)

Overview

This snippet shows how to prevent the screen saver from activating in an application by using Qt Mobility's QSystemScreenSaver class.

Preconditions

Qt Mobility 1.0.2 or higher is installed.

Project configuration file (.pro) file

Add the Qt Mobility project configuration option in the .pro file as shown below.

CONFIG += mobility
MOBILITY += systeminfo

Header file

Add the inclusion of <QSystemScreenSaver>.

#include <QSystemScreenSaver>

Add the QSystemScreenSaver object as member to your QObject-derived class and set the inhibiter to active by calling the setScreenSaverInhibit() method. The inhibiter will continue to prevent the screen saver from activating as long as the QSystemScreenSaver object exists.

class MyObject : public QObject
{
    MyObject() {
        bool success = screenSaverInhibiter.setScreenSaverInhibit();
        if(success == false) {
            // Failed to set the screen saver inhibiter.
            // The platform may not have a default screen saver implementation
            // or system policies may prevent the setting of the inhibiter. 
        }
    }
protected:
    QSystemScreenSaver screenSaverInhibiter;
};

Postconditions

The code snippet demonstrated a way to inhibit the screen saver from activating.