diff -r ebc84c812384 -r 46218c8b8afa Symbian3/PDK/Source/GUID-FF82B80D-18CA-5333-83EB-3AB94F696016.dita --- a/Symbian3/PDK/Source/GUID-FF82B80D-18CA-5333-83EB-3AB94F696016.dita Thu Mar 11 15:24:26 2010 +0000 +++ b/Symbian3/PDK/Source/GUID-FF82B80D-18CA-5333-83EB-3AB94F696016.dita Thu Mar 11 18:02:22 2010 +0000 @@ -1,94 +1,94 @@ - - - - - -Options-List -

Options-List can be specified within a PKG file to display a list -of options to the Symbian device user during installation. The options that -are selected, control the installation of optional components.

-
Syntax!({"Option string language 1",...},...) -

For example,

- -!({"Add-on 1 (20KB)"},{"Add-on 2 (75KB)"}, - {"Add-on 3 (80KB)"},{"Add-on 4 (20KB)"}) -

Each string corresponds to a PKG file variable called option1, option2 and -so on. The following are the values of these options:

    -
  • Value 0 signifies -that the option is not selected.

  • -
  • Value 1 signifies -that the option is selected.

  • -

The selection affects the values of option attributes (option1, -option2, option3, ...). In the preceding example, if option1 (Add-on -1 (20KB)) is selected, then the value of the option1 attribute -changes from 0 to 1.

You can test -these values by specifying the optional components within conditional blocks -as shown in the following example:

If option1 = 1 -; install optional file 1 to the private directory - "sample.txt"-"!:\private\E800005A\sample.txt"; -endif - -If option2 = 1 -; install optional file 2 to the private directory - "sample2.txt"-"!:\private\E800005A\sample2.txt"; -endif
-

Note: The option<n> attributes behave -as global variables.

-Examples
    -
  • The following example -package file illustrates the usage of a basic options list.

    ;Languages -&EN - -%{"Nokia Corporation"} - -:"Nokia Corporation" - -;Header -#{"Options"}, (0x81111107), 1, 2, 3,TYPE=SA - -;Display 3 options to the user -!({"Install document (1KB)"},{"Install document2 (1KB)"},{"Install document3 (1KB)"}) - -if option1 = 1 - "files\option1.txt"-"!:\private\81111108\option1.txt"; -endif - -if option2 = 1 - "files\option2.txt"-"!:\private\81111108\option2.txt"; -endif - -if option3 = 1 - "files\option3.txt"-"!:\private\81111108\option3.txt"; -endif
  • -
  • The following example -package file demonstrates an option list that supports multiple languages.

    ;Languages -&EN,FR - -;Header -#{"MultiLanguageOption-EN", "MultiLanguageOption-FR"}, (0x81111107), 1, 2, 3 - -%{"Vendor","Vendeur"} -:"Vendor" - -!({"ENOption1", "FROption1"},{"ENOption2","FROption2"},{"ENOption3","FROption3"}) - -if option1 = 1 - {"text\englishfile1.txt" "text\frenchfile1.txt"}-"!:\private\81111108\import\file1.txt"; -endif - -if option2 = 1 - {"text\englishfile2.txt" "text\frenchfile2.txt"}-"!:\private\81111108\import\file2.txt"; -endif - -if option3 = 1 - {"text\englishfile3.txt" "text\frenchfile3.txt"}-"!:\private\81111108\import\file3.txt"; -endif -
  • -
+ + + + + +Options-List +

Options-List can be specified within a PKG file to display a list +of options to the Symbian device user during installation. The options that +are selected, control the installation of optional components.

+
Syntax!({"Option string language 1",...},...) +

For example,

+ +!({"Add-on 1 (20KB)"},{"Add-on 2 (75KB)"}, + {"Add-on 3 (80KB)"},{"Add-on 4 (20KB)"}) +

Each string corresponds to a PKG file variable called option1, option2 and +so on. The following are the values of these options:

    +
  • Value 0 signifies +that the option is not selected.

  • +
  • Value 1 signifies +that the option is selected.

  • +

The selection affects the values of option attributes (option1, +option2, option3, ...). In the preceding example, if option1 (Add-on +1 (20KB)) is selected, then the value of the option1 attribute +changes from 0 to 1.

You can test +these values by specifying the optional components within conditional blocks +as shown in the following example:

If option1 = 1 +; install optional file 1 to the private directory + "sample.txt"-"!:\private\E800005A\sample.txt"; +endif + +If option2 = 1 +; install optional file 2 to the private directory + "sample2.txt"-"!:\private\E800005A\sample2.txt"; +endif
+

Note: The option<n> attributes behave +as global variables.

+Examples
    +
  • The following example +package file illustrates the usage of a basic options list.

    ;Languages +&EN + +%{"Nokia Corporation"} + +:"Nokia Corporation" + +;Header +#{"Options"}, (0x81111107), 1, 2, 3,TYPE=SA + +;Display 3 options to the user +!({"Install document (1KB)"},{"Install document2 (1KB)"},{"Install document3 (1KB)"}) + +if option1 = 1 + "files\option1.txt"-"!:\private\81111108\option1.txt"; +endif + +if option2 = 1 + "files\option2.txt"-"!:\private\81111108\option2.txt"; +endif + +if option3 = 1 + "files\option3.txt"-"!:\private\81111108\option3.txt"; +endif
  • +
  • The following example +package file demonstrates an option list that supports multiple languages.

    ;Languages +&EN,FR + +;Header +#{"MultiLanguageOption-EN", "MultiLanguageOption-FR"}, (0x81111107), 1, 2, 3 + +%{"Vendor","Vendeur"} +:"Vendor" + +!({"ENOption1", "FROption1"},{"ENOption2","FROption2"},{"ENOption3","FROption3"}) + +if option1 = 1 + {"text\englishfile1.txt" "text\frenchfile1.txt"}-"!:\private\81111108\import\file1.txt"; +endif + +if option2 = 1 + {"text\englishfile2.txt" "text\frenchfile2.txt"}-"!:\private\81111108\import\file2.txt"; +endif + +if option3 = 1 + {"text\englishfile3.txt" "text\frenchfile3.txt"}-"!:\private\81111108\import\file3.txt"; +endif +
  • +
\ No newline at end of file