Home · All Classes · Grouped Classes · Annotated · Functions

SystemSuspendHandler Class Reference

The SystemSuspendHandler class provides an interface for tasks that provide system suspension or resumption functionality. More...

    #include <SystemSuspendHandler>

Inherits QObject.

Public Functions

Signals

Additional Inherited Members


Detailed Description

The SystemSuspendHandler class provides an interface for tasks that provide system suspension or resumption functionality.

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

Server components can use the SystemSuspendHandler to integrate into Qtopia's suspend mechanism.

Tasks that provide the SystemSuspendHandler interface will be called whenever a system suspend is requested through the SystemSuspend class. More information on how a system suspend proceeds, including the order in which SystemSuspendHandler implementers are called, is available in the documentation for that class.

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

See also SystemSuspend.


Member Function Documentation

SystemSuspendHandler::SystemSuspendHandler ( QObject * parent = 0 )

Construct the handler with the given parent.

bool SystemSuspendHandler::canSuspend () const   [pure virtual]

Returns true if the handler is capable of suspending at the time it is called. Suspend handlers can return false from this call to prevent the system from entering a suspended state. This might be useful to prevent a suspend during a device synchronization or other scenarios where it may be advantageous not to enter such a state.

void SystemSuspendHandler::operationCompleted ()   [signal]

Emitted to indicate that the suspend or wake process can continue. This should only be emitted after previously returning false from suspend() or wake().

bool SystemSuspendHandler::suspend ()   [pure virtual]

Perform the handler's suspend action. If this method returns false, the suspend process will pause - entring the Qt event loop - until the handler emits the operationCompleted() signal. This can be used to perform asynchronous actions in the handler.

Normally this method will return true.

bool SystemSuspendHandler::wake ()   [pure virtual]

Perform the handler's wake action. If this method returns false, the wake process will pause - entering the Qt event loop - until the handler emits the operationCompleted() signal. This can be used to perform asynchronous actions in the handler.

Normally this method will return true.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3