/*

* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:

*

* Description:  Container class for Location Centre Application UI.

*

*/

#ifndef C_LCCONTAINER_H

#define C_LCCONTAINER_H

// SYSTEM INCLUDES

#include <coecntrl.h>

#include <eiklbo.h>

// FORWARD DECLARATIONS

class CLcAppUi;

class CLcListBoxModel;

class CAknSingleLargeStyleListBox;

class MLcEventHandler;

/**

 *  Location Centre Application's Container class. This class is the chief

 *  windowing component of Location Centre which displays the List of

 *  Location based Applications and Contents/Services

 *

 *  @lib lcapp.exe

 *  @since S60 v5.0

 */

class CLcContainer : public CCoeControl,

					 public MEikListBoxObserver

    {

public:

	/**

	 * Static Two phase constructor

	 *

	 * @param[in] aRect, 		 Client Rectangle for this window owning control.

	 * @param[in] aEventHandler, Location Centre Event Handle.

	 * @param[in] aListBoxModel, List box model.

	 */

	static CLcContainer* NewL( const TRect& 			aRect,

									 MLcEventHandler&	aEventHandler,

									 CLcListBoxModel&	aListBoxModel );

  	/**

  	 * Virtual destructor

  	 */

    ~CLcContainer();

    /**

     * Returns the help context

     *

     * @param aContext  The help context that has to be determined

     */

    void GetHelpContext( TCoeHelpContext& aContext ) const;

    /**

     * Returns the Selected List box item

     *

     * @return TInt Index corresponding selected List box item.

     */

    TInt GetFocussedItem();     

    /**

     * Updates the Container object with a new list of Location based Applications

     * and Contents/Services.

     *

     * @param[in] aListBoxModel, New List box model object.

     */

 	void UpdateL( CLcListBoxModel&	aListBoxModel );

 	/**

 	 * Updates the listbox icons for Location Centre List Box.

 	 */

	void UpdateIconsL(); 	

protected: // Inherited from Base classes

  	/**

  	 * Inherited from CCoeControl

  	 */  

    void SizeChanged();

  	/**

  	 * Inherited from CCoeControl

  	 */

    TInt CountComponentControls() const;

  	/**

  	 * Inherited from CCoeControl

  	 */

    CCoeControl* ComponentControl( TInt aIndex ) const;

  	/**

  	 * Inherited from CCoeControl

  	 */    

    TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent,

                         			   TEventCode aType );

	/**

	 * Inherited from CCoeControl

	 */

	void HandleResourceChange( TInt aType );	                         			                    			                   			   

    /**

     * Inherited from MEikListBoxObserver

     */

    void HandleListBoxEventL( CEikListBox*      aListBox, 

                              TListBoxEvent     aEventType );

    /**

     * Handles Focus Change to list 

     */

    void FocusChanged( TDrawNow aDrawNow );                              

private:

	/**

	 * C++ Default constructor

	 */

    CLcContainer( MLcEventHandler&	aEventHandler,

    			  CLcListBoxModel&	aListBoxModel );

	/**

	 * Second phase of the two phase constructor

	 */     

    void ConstructL( const TRect& 	aRect );

    /**

     * Sets the Title text

     * @param aResourceText Resource to create title

     */

    void MakeTitleL( TInt aResourceText );

	/**

	 * Creates the List box and List box model.

	 */     

    void CreateListboxL();

public:

	/**

	 * List box

	 * Owns

	 */

	CAknSingleLargeStyleListBox*	iListBox;

    /**

     * Help context

     */

    TCoeContextName                 iContextName;

    /**

     * Location Centre Event handler

     */

    MLcEventHandler&				iEventHandler;

    /**

     * Location Centre list box model

     */    

    CLcListBoxModel*				iListBoxModel;	    

	};

#endif  // C_LCCONTAINER_H

// End of File