ApplicationTypeLauncher Class Reference
[QtBaseModule]

Detailed Description

The ApplicationTypeLauncher class provides an interface to control a particular application type in the system.

The ApplicationTypeLauncher provides a Qt Extended Server Task interface. Qt Extended Server Tasks are documented in full in the QtopiaServerApplication class documentation.

Note: This class is part of the Qt Extended server and cannot be used by other Qt Extended applications.

ApplicationTypeLauncher implementers are used by the ApplicationLauncher to control a specific type of application. An overview of the application launcher mechanism is given in the documentation of the ApplicationLauncher class.

Member Type Documentation

enum ApplicationTypeLauncher::ApplicationState

Represents the state of an application.

enum ApplicationTypeLauncher::TerminationReason

Represents the reason an application terminated.

Member Function Documentation

ApplicationTypeLauncher::~ApplicationTypeLauncher ()   [virtual]

Destruct the ApplicationTypeLauncher instance.

ApplicationState ApplicationTypeLauncher::applicationState ( const QString & application )   [pure virtual]

Return the current state of the application.

void ApplicationTypeLauncher::applicationStateChanged ( const QString & application, ApplicationTypeLauncher::ApplicationState state )   [signal]

Emitted whenever the application state changes. state will be the application's new state.

bool ApplicationTypeLauncher::canLaunch ( const QString & application )   [pure virtual]

Return true if this ApplicationTypeLauncher can launch the application.

void ApplicationTypeLauncher::kill ( const QString & application )   [pure virtual]

Kill the application.

void ApplicationTypeLauncher::launch ( const QString & application )   [pure virtual]

Attempt to launch the application.

QString ApplicationTypeLauncher::name ()   [pure virtual]

Return a descriptive name for the ApplicationTypeLauncher type.

void ApplicationTypeLauncher::pidStateChanged ( const QString & application, Q_PID pid )   [signal]

This signal is used by the memory monitor. If pid is empty the Qtopia application exited; otherwise pid is greater than zero. Most server classes should use the terminated() or applicationStateChanged() signal.

void ApplicationTypeLauncher::terminated ( const QString & application, ApplicationTypeLauncher::TerminationReason reason )   [signal]

Emitted whenever the application terminates. reason represents the cause of the termination.