/*! \mainpage Listbox Control Example
 *	
 * \ref intro_sec
 * \n\ref Pre_sec
 * \n\ref Design_sec
 * \n\ref Hierarchy_sec
 *
 * <HR>
 *
 * \section intro_sec 1. About this Example
 *
 * This tutorial explains how to use Listbox controls for Avkon application. A listbox lists items in its control, and the user can select or edit these items.
 *
 * To use listbox controls in an application, an understanding of the following topics is necessary:
 * 
 * - Types of classes and the functions they provide.
 * - The structure of these classes,particularly MEikListBoxObserver, CListBoxView, CEikListBox.
 * - Writing listbox resources and using them.
 * - Implementing listbox-related classes and their functions.
 *
 * The example application introduces the following listbox controls:
 *
 * <b>Single item</b>
 * Standard (1 row = 1 item)
 * 
 * <b>Single item with number</b>
 * An ordinal number for the list item is shown.
 * 
 * <b>Single item with text</b>
 * A text heading is shown for each item.
 *
 * <b>Single item with graphic</b>
 * A bitmap icon heading is shown for each item.
 * 
 * <b>Single item with large graphic</b>
 * A large bitmap icon heading is shown for each item.
 * 
 * <b>Single item with graphic and text</b>
 * A bitmap icon and a text heading are shown for each item.
 * 
 * <b>Single item with number and text</b>
 * An ordinal number and a text heading are shown on each item.
 *
 * <b>Big single item</b>
 * The listbox has a higher row height than the standard row height (higher listbox).
 *
 * <b>Big single item with number</b>
 * Higher listbox with ordinal number.
 *
 * <b>Big single item with large graphic</b>
 * Higher listbox with large bitmap icon.
 *
 * <b>Double item</b>
 * Double listbox (1 row = 2 items)
 *
 * <b>Double item with number</b>
 * Double listbox with ordinal number.
 *
 * <b>Double item with graphic</b>
 * Double listbox with bitmap icon.
 *
 * <b>Double item with large graphic</b>
 * Double listbox with large bitmap icon.
 *
 * <b>Double item with time</b>
 * Double listbox with time data.
 *
 * <b>Setting number item</b>
 * Setting listbox with ordinal number
 *
 * <b>Setting item</b>
 * Setting listbox with an On/Off setting
 *
 * <HR>
 *
 * \section Pre_sec 2. Prerequisites
 *    
 * This example makes use of the standard Symbian OS application framework, comprising the Application, Document, UI, and View classes. The reader should be aware of this architecture before attempting to understand this example.
 *
 * <HR>
 *
 * \section Design_sec 3. Design and Implementation
 *  
 * \subsection Sub31 3.1 Capabilities
 *
 * The program capabilities are defined in %aknexlist.mmp file: CAPABILITY NONE.
 *
 * \subsection Sub2 3.2 ScalabaleUI
 *	
 * The program takes screen parameters in the start of the application and works with all screen modes. The program supports changing the screen layout while the program is running.
 * 
 * \subsection Sub33 3.3 Design
 *	
 * To implement listbox functions, five classes, including CEikListBox, MEikListBoxObserver, MListBoxModel, CListBoxView, CLisItemDrawer, are very important. To understand the listbox, it is necessary to see these classes. arious types of listbox in Avkon are derived from CEikListBox.
 *
 * Note: In this example application, CAknGrid is not used. It is described in the grid example.
 *
 * \subsection Sub331 3.3.1 Listbox and related classes
 *
 * For listbox functions, the following classes are used:
 *
<div align=center><table style="width:90%;" cellspacing="0" width="90%" border="1" class="hcp15">

<tr>
<td style="width:35%;" align="center" valign="top" width="35%" class="hcp16">
<p class=TableText
	style="font-weight: bold; text-align: left;"
	align=left><i><span class="hcp17">Class</span></i></td>
<td style="width:17.827%;" align="center" valign="top" width="17.827%" class="hcp16">
<p class=TableText
	style="font-weight: bold; text-align: left;"
	align=left><i><span class="hcp17">Definition</span></i></td>
<td style="width:29.235%;" align="center" valign="top" width="29.235%" class="hcp16">
<p class=TableText
	style="font-weight: bold; text-align: left;"
	align=left><i><span class="hcp17">Description</span></i></td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CEikListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbx.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for Command Handling</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CEikSnakingListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbx.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for SnakingListBox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknColumnListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for ColumnListBox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>MEikListBoxObserver</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbo.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for Observer of Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>MListBoxModel</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbm.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for Listbox Mdoel</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CListBoxView</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbv.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for Listbox View</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CListItemDrawer</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>eiklbi.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for Drawing Item of List</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for SingledStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleNumberStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for NumberStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleHeadingStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for HeadingStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleGraphicStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for GraphicStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleGraphicHeadingStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for GraphicHeadingStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleNumberHeadingStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for NumberHeadingStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknSingleLargeStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for SingleLargeStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknDoubleStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for DoubleStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknDoubleNumberStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for DoubleNumberStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknDoubleLargeStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for DoubleLargeStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknDoubleGraphicStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>
<td style="width:29.235%;" valign="top" width="29.235%" class="hcp18">defined interface for GraphicStyle Listbox</td></tr>

<tr>
<td style="width:35%;" valign="top" width="35%" class="hcp18">
<p class=CodeInTable><span class=CodeInText>CAknDoubleTimeStyleListBox</span></td>
<td style="width:17.827%;" valign="top" width="17.827%" class="hcp18"><span class=CodeInText>aknlists.h</span></td>