<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE reference

  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference id="GUID-FF82B80D-18CA-5333-83EB-3AB94F696016" xml:lang="en"><title>Options-List</title><prolog><metadata><keywords/></metadata></prolog><refbody>

<section><p>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. </p> </section>

<section><title>Syntax</title><codeblock id="GUID-8E47AFB4-B035-599F-8B9F-1B7729228BA4" xml:space="preserve">!({"Option string language 1",...},...)

</codeblock> <p>For example, </p> <codeblock id="GUID-4DFE5803-1442-51E8-BC6B-B7CE84586B03" xml:space="preserve">

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

  {"Add-on 3 (80KB)"},{"Add-on 4 (20KB)"}) 

</codeblock> <p>Each string corresponds to a PKG file variable called <codeph>option1</codeph>, <codeph>option2</codeph> and

so on. The following are the values of these options: </p> <ul>

<li id="GUID-36EAB6F5-6019-56B0-B63A-3D31FF2EADF1"><p>Value <codeph>0</codeph> signifies

that the option is not selected. </p> </li>

<li id="GUID-8364E286-AF83-5528-8DFC-553C7B4AC18E"><p>Value <codeph>1</codeph> signifies

that the option is selected. </p> </li>

</ul> <p>The selection affects the values of option attributes (<codeph>option1,

option2, option3, ...</codeph>). In the preceding example, if option1 (<codeph>Add-on

1 (20KB)</codeph>) is selected, then the value of the <codeph>option1</codeph> attribute

changes from <codeph>0</codeph> to <codeph>1</codeph>. </p> <p>You can test

these values by specifying the optional components within conditional blocks

as shown in the following example: </p> <codeblock id="GUID-75DAA0F6-48CE-5274-9762-4481CDB26FFA" xml:space="preserve">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</codeblock> </section>

<section><p> <b>Note:</b> The<codeph> option&lt;n&gt;</codeph> attributes behave

as global variables. </p> </section>

<example id="GUID-4A2F5CA7-6571-5B53-86B7-FB77F3AB6CDA-GENID-1-10-1-4-1-1-5-1-6-1-6-1-8-1-3-1-8-1-5-1-2-4"><title>Examples</title> <ul>

<li id="GUID-D326F784-0D83-59DC-B30B-9AFDB0B009B2"><p>The following example

package file illustrates the usage of a basic options list. </p> <codeblock id="GUID-BDBD6AD9-C795-5448-87D5-B9B4E6CE9011" xml:space="preserve">;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</codeblock> </li>

<li id="GUID-ABF7F8B9-2788-505D-B276-CF75368CD497"><p>The following example

package file demonstrates an option list that supports multiple languages. </p> <codeblock id="GUID-08E54984-A832-533B-AB6E-7107874F19E0" xml:space="preserve">;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

        </codeblock> </li>

</ul> </example>

</refbody></reference>