Collapse all Symbian^3 Application Developer Library

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

Parent topic: Package-Body