diff -r 4d198a32ac7d -r d4809db37847 plugins/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-7DD6AB91-0582-4A46-9E19-2F12DC2FE674.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/plugins/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-7DD6AB91-0582-4A46-9E19-2F12DC2FE674.html Thu Aug 19 17:48:04 2010 -0700 @@ -0,0 +1,134 @@ + + +Criteria for +launching an application

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 (stand-alone). For more information on 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 stand-alone 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 stand-alone application +is launched in the background.

  • +
  • "Foreground" - The stand-alone 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"

+
\ No newline at end of file