/*

* Copyright (c) 2006 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:  Location Notation Preferences Plugin View's container

*

*/

#ifndef C_LOCNOTPREFPLUGINCONTAINER_H_

#define C_LOCNOTPREFPLUGINCONTAINER_H_

// System Includes 

#include <e32base.h>

#include <coecntrl.h>

#include <eiklbo.h>

// Forward Declarations

class MDesCArray;

class MLocNotPrefPluginCmdHdlr;

class CAknSettingStyleListBox;

// Class Definition

/**

 * Container for the CLocNotPrefPluginView.

 */

class CLocNotPrefPluginContainer : public CCoeControl,

                                   public MEikListBoxObserver

    {

    public:

        /**

         * Static Two phase contructor that instantiates the CLocNotPrefPluginContainer

         * 

         * @param aRect                         Client rectangle

         * @param aListBoxModel                 Model for the container's list box

         * @param aCmdHandler                   List box command handler

         * @return CLocNotPrefPluginContainer*  Reference to the object created

         */

        static CLocNotPrefPluginContainer* NewL( 

                                const TRect&                    aRect,

                                      MDesCArray&               aListBoxModel,

                                      MLocNotPrefPluginCmdHdlr& aCmdHandler );

        /**

         * Static Two phase contructor that instantiates the CLocNotPrefPluginContainer

         * Leaves the object on the Cleanup stack

         * 

         * @param aRect                         Client rectangle

         * @param aListBoxModel                 Model for the container's list box

         * @param aCmdHandler                   List box command handler     

         * @return CLocNotPrefPluginContainer*  Reference to the object created

         */

        static CLocNotPrefPluginContainer* NewLC(

                                const TRect&                    aRect,

                                      MDesCArray&               aListBoxModel,

                                      MLocNotPrefPluginCmdHdlr& aCmdHandler );

        /**

         * Destructor

         */

        ~CLocNotPrefPluginContainer();

        /**

         * Returns the currentlt focussed element.

         *

         * @return TInt Index of the item selected

         */

        TInt GetFocussedItem();

        /**

         * Inherited from CCoeControl

         */

        void HandleResourceChange(TInt aType);

        /**

         * From CoeControl

         */

        TInt CountComponentControls() const;

        /**

         * From CCoeControl

         */

        CCoeControl* ComponentControl(TInt aIndex) const;

        /**

         * Inherited from CCoeControl

         */

        TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent,

                                           TEventCode aType );

        /**

         * Inherited from MEikListBoxObserver

         */

        void HandleListBoxEventL( CEikListBox*      aListBox, 

                                  TListBoxEvent     aEventType );        

        /**

         * Returns the help context

         *

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

         */

        void GetHelpContext( TCoeHelpContext& aContext ) const;

        /**

         * Handles the pointer events

         */

        void HandlePointerEventL( const TPointerEvent &aPointerEvent );

    protected:

        /**

         * Handles Focus Change to list 

         */

        void FocusChanged(TDrawNow aDrawNow);

        /**

         * From CoeControl,SizeChanged.

         */

        void SizeChanged();

    private:

        /**

         * Overloaded Constructor

         */

        CLocNotPrefPluginContainer( MDesCArray&               aListBoxModel,

                                    MLocNotPrefPluginCmdHdlr& aCmdHandler );

        /**

         * Second phase of the two phase Construction process

         */

        void ConstructL( const TRect& aRect );

        /** 

         * Creates the List box and the Listbox model. Associates the 

         * list box model wit the list box

         *         

         */

        void CreateListboxL();

        /**

         * Sets the Title text

         * @param aResourceText Resource to create title

         */

        void MakeTitleL( TInt aResourceText );

         /**

          * Returns the Appui's status pane

          * @return CEikStatusPane* Statuspane pointer

          */

         CEikStatusPane* StatusPane();

    private:

        /**

         * Reference to the List box model

         */

        MDesCArray&                 iListBoxModel;

        /**

         * Reference to the List box command handler

         */

        MLocNotPrefPluginCmdHdlr&   iCmdHandler;

        /**

         * Settings list box for SUPL settings

         * Owns

         */

        CAknSettingStyleListBox*        iListBox;

        /**

         * Help context

         */

        TCoeContextName                 iContextName;

  };

#endif // C_LOCNOTPREFPLUGINCONTAINER_H_