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

QtopiaAppService Class Reference

Provides the Qt Extended built-in service. More...

    #include <QtopiaAppService>

Inherits QtopiaAbstractService.

• List of all members, including inherited members

Public Slots

• void close ()
• void disablePreload ()
• void enablePreload ()
• void flush ()
• void quit ()
• void quitIfInvisible ()
• void raise ()
• void reload ()
• void setDocument ( const QString & doc )

• 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

Provides the Qt Extended built-in service.

The QtopiaApplicationService describes messages that all Qt Extended applications respond to, without the application programmer needing to do anything special to enable them.

For example, every application has a raise() message that can be used to automatically execute and raise the application as follows:

    QtopiaIpcEnvelope e( "QPE/Application/foo", "raise()" );

Member Function Documentation

void QtopiaAppService::close ()   [slot]

Make the application's main window "go away". If the application is preloaded, this will merely hide the main window. Otherwise this calls QCoreApplication::quit().

void QtopiaAppService::disablePreload ()   [slot]

Disable preloading of this application. This will cause the close() message to quit the application rather than just hide the main window.

void QtopiaAppService::enablePreload ()   [slot]

Enable preloading of this application. This will cause the close() message to hide the main window rather than quitting.

void QtopiaAppService::flush ()   [slot]

Tell the application to flush all of its data to disk in preparation for syncing with a desktop system. This will cause the QtopiaApplication::flush() signal to be emitted, which the application can connect to if it needs to perform non-trivial operations to flush its data.

void QtopiaAppService::quit ()   [slot]

Ask the application to quit if doing so will not lose state. Internally, this calls QtopiaApplication::tryQuit().

void QtopiaAppService::quitIfInvisible ()   [slot]

Quit the application if it has no windows currently displayed. Internally, this calls QCoreApplication::quit().

void QtopiaAppService::raise ()   [slot]

Raise this application to the top-most position and make its main window visible.

void QtopiaAppService::reload ()   [slot]

Tell the application to reload its data after syncing with a desktop system. This will cause the QtopiaApplication::reload() signal to be emitted, which the application can connect to if it needs to perform non-trivial operations to reload its data.

void QtopiaAppService::setDocument ( const QString & doc )   [slot]

Set the document to be displayed in the application to doc. If the main window object has a setDocument(QString) slot, then that slot will be invoked automatically, with doc as its argument.