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