Package : DoubleStyle Image Listbox

Platform : UIQ 2.1

Author : Sanket Lopez

Purpose : The UIQ platform has a dearth of ListBox types as compared to the Series60 Platform. The included binaries provide support for ListBox's which supports two lines of text and an optional image per row.

Change Log

  12-01-2004 - Release V 1.0
Initial.

  23-01-2004 - Release V 1.1
Added Support for Jog-Dial.Documentation Updates & Fixes.

  26-07-2004 - Release V 1.2
Better Example Code.

Package

ReleasePackage_v1.2.zip

Installation

Unzip the archive to any folder and make sure the directory structure is maintained.

  ARMI : Copy the DBSTLIMGLB.LIB and DBSTLIMGLB.DLL from the ARMI folder to your UIQ SDK's \epoc32\release\armi\urel folder. Copy the header file DBSTLIMGLB.H to your \epoc32\include folder.

  WINSCW : Copy the DBSTLIMGLB.LIB and DBSTLIMGLB.DLL from the WINSCW folder to your UIQ SDK's \epoc32\release\winscw\udeb folder. Copy the header file DBSTLIMGLB.H to your \epoc32\include folder.

SIS File Creation

Add the DBSTLIMGLB.DLL to your package file (PKG) so it is copied to the install directory of your application.

An example would be :

"C:\Symbian\UIQ_70\epoc32\release\armi\urel\dbstlimglb.dll" - "!:\system\apps\Simple\dbstlimglb.dll"

Usage

Include the header file in your source and link against DBSTLIMGLB.LIB. The CDoubleStyleColumnListBox is created and used in the same manner as a normal CEikListBox.

To complete the construction, two more functions must be called,
  Firstly, the fonts for Line 1 and Line 2 of the text. To set these fonts, call the SetOwnFonts(const CFont* aFontOne, const Cfont* aFontTwo) which is in the Item Drawer. For example,

iMyListBox->ItemDrawer()->SetOwnFonts(iLine1Font, iLine2Font);

  Secondly, the Parent View has to be initialized. Use the SetParentView() method for the same. For example,

iMyListBox->ItemDrawer()->SetParentView(iMyListBox->View());

The above two steps should be done before activating the ListBox. All other construction steps are similar to the CEikListBox.

To add an element to the Listbox, get the Listbox ItemArray and keep appending elements to it. A '\n' character (NewLine) in the string will take you to the Second line however another '\n' char in the same column will have no effect. A '\t' (TAB) character will go to next column provided the column has already been set while constructing the Listbox.

Jog Implementation

There are no problems for using the JOG-DIAL in your list box; DoubleStyleColumnListbox makes jog implementation as easy as two steps,

  Firstly, while constructing the listbox give a call to the function EnableJog().
Declaration:

void EnableJog(TBool aValue =ETrue);

  Secondly, as the Application UI will catch all the keys we need to implement a function HandleKeyEventL() in AppUi. In this function we need to pass the aKeyEvent to Listbox's internal function HangleJogEvents().
Declaration:

TKeyResponse HangleJogEvents(const TKeyEvent& aKeyEvent);

Example Code will take the form shown below :-

Example

An Example is Provided in the "TestApp" directory, to show the usage of the Dll.

Support

<center><Font color="green"> support@arisetech.net</Font></center>