2. Developed by :
Enterprise System Solutions Pvt. Ltd. (ESSPL)
Infocity, Bhubaneswar, India – 751024
www.esspl.com
Component Author:
Samir K. Dash, Systems Consultant, ESSPL
Component Page URL : http://www.esspl.com/FlashComponents/xmllistboxlitehome.asp
Support Information
On purchase of this component, a support e-mail is provided that is valid for 1 month from the
date of purchase. During this period you can forward all your queries regarding installation,
troubleshooting and additional support to use the component effectively for your application.
Apart from this no additional support is provided and for the trial and purchased versions the
product is provided on as-is basis.
License Agreement for XMLListBoxLite
XMLListBoxLite is sold/ distributed by Enterprise System solutions Pvt. Ltd. (ESSPL) as
is without any warranties whatsoever. By using this Flash component you accept the fact
that ESSPL will not be liable for any damage it may cause.
Disclaimer:
® Flash® is the registered trademark of Adobe Systems INC.
All content/ information presented here is the exclusive property of Enterprise system solutions Pvt. Ltd. (ESSPL).
The copyrights of trade marks/ logos of any other organizations/ companies/ vendors are under their respective
copyright holders and are in no way linked to ESSPL or any of its subsidiaries. The content/ information contained
here is correct at the time of its publishing. No material from here may be copied, modified, reproduced,
republished, uploaded, transmitted, posted or distributed in any form without prior written permission from ESSPL.
3. Contents
1. About XMLListBoxLite
2. Contents of the SDK
3. Features of the Component
4. Install the Component
5. Know the Component Parameters
6. Listing Your Contents
7. Associate events with list item
8. Keys associated with this component
9. Publishing your Application
About XMLListBoxLite
XML ListBox Lite is a Flash component for Flash Lite 2.0 application development for mobile
phones. Creating a lightweight dynamic list box for Flash Lite application becomes as easy as a
snap using this component. Now no more the Flash Lite application developers need to be
worried about creating dynamically populated list box that will work on nearly every symbian
series 60 models which support Flash Lite 2.0.
XML ListBox Lite comes handy when you plan to create a dynamic list which is populated with
the data sourced from a simple XML file , such creating a play list for your Flash Lite MP3 Player
application, creating a list for a shopping catalogue etc.
Contents of the SDK
The XML ListBoxLite SDK contains the following:
4. 1. xmlListBoxLite.mxp
2. list.xml (it is a sample XML. You have to modify to fit your needs)
Features of the Component
XML ListBoxLite is a complete solutions for creating customized xml driven dynamic lists in
Flash Lite 2 mobile application development.
The basic features of the component are:
1. Create Unlimited Number of Tabs: XML ListBoxLite can populate any number of tabs
and provides proper visualization and navigation of these tabs.
2. Fully Functional Scrollbars: The scrollbars position ratio is auto adjusted by the
number of tabs that appear in the list, which gives the users whether any tabs are left in
the list to scroll.
3. Display Tabs as per needs: This list component allows you to display any number of
tabs from the range of 8, 4, 2 and 1, at any instance. This serves the need for example
when you have more text to display you can choose 4 or 2 tabs so that you need not
compromise on the content side.
4. Customize the Look and Feel: You can set any color as parameters for different
elements of this list component so that it will fit your application seamlessly.
5. Virtually zero time to implement: This component does not require any extra
programming in FlashLite 2.0 Action script to display your contents. Just update the xml
list and it is ready for use.
6. Lightweight and User friendly: XMLListBoxLite offers you great glossy look and
advanced features within just 17 KB . The user experience is also magnetic.
Install the Component
5. Double click on thexmlListBoxLite.mxp file to run it. If you have Flash 8 or
above version installed in your system then it will open the Macromedia Extension manager and
you will be then asked to accept the terms. If you agree to the conditions then the extension will
be automatically installed.
Now open Flash 8 IDE and in components panel you will see the component under
ESSPLComponents folder.
Know the Component Parameters
6. Arrow Background Color
This defines the color of the background of the little arrow icon at the top and button of the scroll
bar. The default RGB value is 0xcecfce.
Arrow Color
This defines the color of the arrow at the top and the bottom of the scrollbar.
HighLighted Tab Color
This defines the color of the item tabs when selected/ highlighted.
7. Highlighted Tab Text Color
This defines the color of the text of the item in highlighted state.
List Background Color
This defines the color of the background of the list .
No. of Menu Items Displayed
This defines the number of items to be displayed at any time. This has possible values of 8, 4, 2
and 1. The following images show different selection results.
Number the List item?
TIf this is set to “Yes” then the serial number of each item appears in each of them.
8. scrollbar Background Color
This defines the color of the color of the scrollbar background.
scrollbar Thumb Color
This defines the color of the scroll bar thumb .
Unselected Tab Color
This defines the color of the items tab in the default state.
Unselected Tab Text Color
This defines the color of the tabs at the default state (when not selected/ highlighted by the user)
9. XML File Path
This defines the file path of the XML file from which the list will be populated.
Listing your contents
The items to be populated in the list are listed in any xml file (in the following example it is the
sample file “list.xml”).
In this XML file you list down all your high level groups as the following format:
- <xmlistboxlite_esspl>
<listitem labelname="Write here the item name to be displayed in the list " itemvalue="Any string or
number value associated with this item is mentioned here."/>
</xmlistboxlite_esspl>
For example, if you have a list structure containing three items namely “Item1”, “Item 2”, “Item 3”
and “Item 4”, with associated values “value1”, “value2”, “value3” and “value4” then you have to
create the list.xml as follows:
- <xmlistboxlite_esspl>
<listitem labelname=" Item 1" itemvalue=" value1"/>
<listitem labelname=" Item 2" itemvalue=" value2"/>
<listitem labelname=" Item 3" itemvalue=" value3"/>
<listitem labelname=" Item 4" itemvalue=" value4"/>
</xmlistboxlite_esspl>
Now these will be reflected in your e-learning interface as shown in the following figure:
10. Associate events with list item
The highlighted Tab related value can be referenced at the “_root” level time line through
the variable “activeItemValue”
For instance in the previous example, when the 1st item in the list is highlighted, the
_root.activeItemValue gets the value of it which is “value1”
_root.activeItemValue = “value1”
Now you can refer this value for your event actions. For example if you
want to move to a particular frame that has the same name as any
particular list item value, then you can place a button on the _root
timeline with the following example.
on (press, keyPress "<Enter>") {
gotoAndStop(activeItemValue);
}
Keys associated with this component
The default keys associated with this component are <Up> and <Down> key presses. Hence, in
the frame you are using this component, you have all other keys available for you to provide other
navigations, such as <Enter>, <Left>, <Right> and Softkeys.
To set softkeys you can use the standard code provided in the ‘Help’ files of Flash IDE. An
example of setting up softkeys is given below:
fscommand2 ("SetSoftKeys", "Left", "Right");
var myListener:Object = new Object ();
myListener.onKeyDown = function () {
if (Key.getCode () == ExtendedKey.SOFT1) {
// Handle left soft keypress event.
gotoAndStop("about");
}
else if (Key.getCode () == ExtendedKey.SOFT2) {
// Handle right soft keypress event.
fscommand2("Quit",true)
}
};
Key.addListener (myListener);
11. Publishing your Application
You need to publish your Flash Lite applications with ActionScript 2.0 settings.
About ESSPL
ESSPL offers a wide range of e-learning, m-Learning and interactive solutions, from
animation, interface design, multimedia assessment need analysis, customized
courseware design, simulations, interactive kiosks, online design solutions, Flash based
mobile content designing and development, to suit the wide range of client needs ranging
from e-learning, m-learning to sales promotional campaign and presentation needs.
For more details on ESSPL’s offerings in e-Learning and interactive design, refer to
ESSPL website at www.esspl.com