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

ApplicationTypeLauncher Class Reference
[QtBaseModule]

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

    #include <ApplicationTypeLauncher>

Inherits QObject.

Inherited by BuiltinApplicationLauncher, ConsoleApplicationLauncher, ExeApplicationLauncher, and QtopiaServerApplicationLauncher.

• List of all members, including inherited members

Public Types

• enum ApplicationState { NotRunning, Starting, Running }
• enum TerminationReason { Normal, Killed, FailedToStart, Crashed, Unknown }

Public Functions

• virtual ~ApplicationTypeLauncher ()
• virtual ApplicationState applicationState ( const QString & application ) = 0
• virtual bool canLaunch ( const QString & application ) = 0
• virtual void kill ( const QString & application ) = 0
• virtual void launch ( const QString & application ) = 0
• virtual QString name () = 0

• 29 public functions inherited from QObject

Signals

• void applicationStateChanged ( const QString & application, ApplicationTypeLauncher::ApplicationState state )
• void pidStateChanged ( const QString & application, Q_PID pid )
• void terminated ( const QString & application, ApplicationTypeLauncher::TerminationReason reason )

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

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.