/*

* Copyright (c) 2007-2008 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:  Setting page for Image/Video quality.*

*/

#ifndef CAMINFOLISTBOXCONTAINER_H

#define CAMINFOLISTBOXCONTAINER_H

//  INCLUDES

#include "CamContainerBase.h"

#include "CamAppController.h"

#include "CamSettingValueObserver.h"

#include "CamSettings.hrh"

#include <AknUtils.h>

#include <eiklbo.h>

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class MAknQueryValue;

class CCamInfoListBox;

class CAknInfoPopupNoteController;

class MTouchFeedback;

// CLASS DECLARATION

/**

* Implements a general setting control, with a listbox with choices 

* in the left and a icon and highlighted item description in the right.

*

*  @since 2.8

*/

class CCamInfoListBoxContainer : public CCamContainerBase, 

                                 public MCamSettingValueObserver,

                                 public MEikListBoxObserver

            {

    public: // Constructors and destructor

        /**

        * Symbian OS two-phased constructor

        * @since 2.8

        * @param aRect Frame rectangle for container.

        * @param aView Reference to the view containing this container

        * @param aController reference to CCamAppControllerBase instance

        * @param aListBoxResource Listbox resource data

        * @param aSummaryResource Summary resource data

        * @param aSettingValue Initial setting value

        */

        static CCamInfoListBoxContainer* NewL( const TRect& aRect, 

                                                 CAknView& aView,

                                                 CCamAppController& aController,

                                                 TInt aListBoxResource,

                                                 TInt aSummaryResource,

                                                 TInt aSettingValue, 

                                                 TInt aTitleResource,

                                                 TBool aSkinnedBackGround = ETrue );

        /**

        * Destructor.

        * @since 2.8

        */

        virtual ~CCamInfoListBoxContainer();

    private:

        /**

        * Symbian OS 2nd phase constructor.

        * @since 2.8

        * @param aRect Frame rectangle for container.

        * @param aListBoxResource

        * @param aSummaryResource

        */

        void ConstructL( const TRect& aRect, TInt aListBoxResource, TInt aSummaryResource, TInt aTitleResource  );

        /**

        * C++ constructor

        * @since 2.8

        * @param aController reference to CCamAppControllerBase instance

        * @param aView Reference to the view containing this container

        * @param aSettingValue Initial setting value

        * display the base scenes for the user scene.

        */

        CCamInfoListBoxContainer(   CCamAppController& aController,

                                    CAknView& aView,

                                    TInt aSettingValue, TBool aSkinnedBackGround = EFalse );

    public: 

        /**

        * Gets the settings item value ID of the current item

        * @since 2.8

        * @return the settings item value of the currently highlighted item

        */

        TInt CurrentSettingItemValue() const;

        /**

        * Returns ETrue if the setting item value has changed

        * @since 2.8

        * @return setting value change status

        */        

        TBool SettingValueChanged() const;

        /**

        * Gets the index in the item array that has the specified settings 

        * item value ID of the current item

        * @since 3.0

        * @return the index of the item with the specified value id

        */

        TInt IndexForValueId( TInt aValueId ) const;

   public: //Functions from base classes

        /**

        * From MCamSettingValueObserver

        * Handles a change in the slider value

        * @since 2.8

        * @param aNewValue the new value of the setting

        */ 

        void HandleSettingValueUpdateL( TInt aNewValue );

    protected: // Functions from base classes

        /**

        * From CoeControl

        * @since 2.8

        * @return number of contained controls

        */

        TInt CountComponentControls() const;

        /**

        * From CCoeControl

        * @since 2.8

        * @param aIndex The index of the required control

        * @return Returns the requested control

        */

        CCoeControl* ComponentControl( TInt aIndex ) const;

        /**

        * From CCoeControl

        * @since 2.8

        * @param aRect area where to draw

        */

        void Draw( const TRect& aRect ) const;

        /**

        * From CamContainerBase 

        * @since 2.8

        * @param aKeyEvent the key event

        * @param aType the type of the event

        * @return TKeyResponse key event was used by this control or not

        */

        TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent,

                                     TEventCode aType );

    private: 

        /**

        * Sets up the summary pane detail arrays

        * @since 2.8

        * @param aResourceId The resource that defines the summary pane details

        */

        void ConstructSummaryDetailsFromResourceL(TInt aResourceId);

        void HandlePointerEventL( const TPointerEvent& aPointerEvent );

        /**

         * From MEikListBoxObserver

         */

        void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType);

        void ShowTooltipL();

        void ConstructContainerTitleFromResourceL( TInt aResourceId );

        /**

        * Draws the summary title and description text

        * @param aGc The graphics context to draw to

        */

        void DrawSummaryTextL( CWindowGc& aGc ) const;

        /**

        * Read touch layout

        * @return TRect, listbox rectangle

        */

        TRect TouchLayout();

        /**

        * Read non-touch layout

        * @return TRect, listbox rectangle

        */

        TRect NonTouchLayout();

    private: // data

        // The listbox itself

				CCamInfoListBox* iListBox;

        // Array of bitmaps for the large summary icon

        RPointerArray<CFbsBitmap> iSummaryBitmapArray;        

        // Array of all shooting mode titles

        RPointerArray<HBufC> iTitleArray;

        // Array of all shooting mode descriptions

        RPointerArray<HBufC> iDescArray;

        TInt iSettingValue;

		// The text shown as the title of the container

        HBufC16* iListboxTitle;

        // info tooltip

        CAknInfoPopupNoteController* iTooltipController;

        TBool iShowTooltip;

        TInt iTooltipIndex;

        // Layout rect for title text

        TAknLayoutText iTitleTextRectLayout;  

        TAknLayoutRect iListboxLayoutRect; 

        TRect iLayoutAreaRect;  

        TRect iExplanationRect; 

        TInt iExplLineCount; // Number of available layouts

        TAknLayoutRect iExplIconLayout;  

        TAknLayoutText iExplTitleLayout;

        RArray<TAknLayoutText> iExplTxtLinesLayout;

        CArrayFixFlat<TPtrC>* iCurrentDescLineArray; // own

        TBool iActivateOnTouchRelease;

        MTouchFeedback* iFeedback; // not own 

        TBool iSkinnedBackGround;        

    };

#endif //CAMINFOLISTBOXCONTAINER_H