Home · All Classes · Grouped Classes · Annotated · Functions

SystemShutdownHandler Class Reference

The SystemShutdownHandler class notifies tasks when the system is shutting down or restarting. More...

    #include <SystemShutdownHandler>

Inherits QObject.

Inherited by ApplicationShutdownTask, ContentServerTask, DocumentServerTask, MediaServerControlTask, SecurityMonitorTask, and ShutdownSplashScreen.

Public Functions

Signals

Additional Inherited Members


Detailed Description

The SystemShutdownHandler class notifies tasks when the system is shutting down or restarting.

The SystemShutdownHandler provides a Qtopia Server Task interface. Qtopia Server Tasks are documented in full in the QtopiaServerApplication class documentation.

Server components can use the SystemShutdownHandler to integrate into Qtopia's shutdown mechanism.

Tasks that provide the SystemShutdownHandler interface are called when the system is shutting down or restarting. By providing this interface, tasks can ensure that they clean up appropriately before a shutdown or restart.

During shutdown or restart, the systemShutdown() or systemRestart() methods are invoked respectively. If a task cannot complete its cleanup synchronously in this invocation, it may return false which indicates that it has not completed. Other handlers will continue to be invoked, but the final shutdown or restart will not occur until all such incomplete handlers have emitted the proceed() signal.

Shutdown is controlled through the QtopiaServerApplication::shutdown() method.

This class is part of the Qtopia server and cannot be used by other Qtopia applications.

See also QtopiaServerApplication.


Member Function Documentation

void SystemShutdownHandler::proceed ()   [signal]

Emitted to indicate the completion of this instances portion of shutdown or restart. This signal should only ever be emitted after the class has delayed the completion of a shutdown or restart by returning false from the systemRestart() or systemShutdown() methods.

bool SystemShutdownHandler::systemRestart ()   [virtual]

Invoked whenever the system is restarting. If the implementer returns true (the default), the system will continue to restart. If it returns false, the system restart will not complete until the instance emits the proceed() signal.

bool SystemShutdownHandler::systemShutdown ()   [virtual]

Invoked whenever the system is shutting down. If the implementer returns true (the default), the system will continue to shut down. If it returns false, the system shut down will not complete until the instance emits the proceed() signal.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3