Criteria for launching an application

The criteria object specifies the application to launch.

The criteria object has three main properties: ApplicationID, CmdLine, and Options. These are described in the following table. Properties enclosed in brackets are optional.

Table: Criteria object properties

Property

Description

Type

Value

criteria.ApplicationID

Specifies a unique ID for the application binary (EXE or DLL).

Use the GetList method to retrieve this ID.

string

For example: "s60uid://0x101F857A"

[criteria.CmdLine]

Specifies a command line argument which is passed to the application being launched.

string

  

[critia.Options]

  

object

Object with the properties specified below.

[critia.Options.Mode]

Specifies whether the launched application is embedded within the application that called LaunchApp (chained) or whether the applications are independent of each other (standalone). For more information about chained and stand-along applications, see section Accessing and launching installed applications.

If this property is not specified, the default is "Standalone".

string

Possible values:

  • "Chained" - The application is embedded within the application that called LaunchApp.

  • "Standalone" - The applications are independent of each other.

[critia.Options.Position]

Specifies whether a standalone application is launched in the background or foreground.

This property is not valid if the Mode is "Chained" (embedded). Embedded applications are automatically launched in the foreground.

If this property is not specified, the default is "Foreground".

string

Possible values:

  • "Background" - The standalone application is launched in the background.

  • "Foreground" - The standalone application is launched in the foreground.

[critia.Options.DocumentPath]

Specifies the full path, including the file name, to the document to launch.

string

For example: "C:\\Data\\abc.txt"
© Nokia 2009.