/*

* 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:  Setting page for CAknEnumeratedItems.*

*/

#ifndef CAMCONTEXTAWARESETTINGPAGE_H

#define CAMCONTEXTAWARESETTINGPAGE_H

//  INCLUDES

#include <AknPopupSettingPage.h>

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CAknEnumeratedTextPopupSettingItem;

class CCamAppController;

// CLASS DECLARATION

/**

*  Setting page class similar to standard avkon CAknPopupSettingPage.

*  Allows the Cba to be updated dynamically according to any limitations 

*  on available items imposed by other setting values or available

*  memory

*

*  @since 2.8

*/

class CCamContextAwareSettingPage : public CAknPopupSettingPage

	{

public: // Constructors, etc.

	/**

	* Construct a list, storing in it a resource (to be read at 2nd stage construction)

	* and a reference to an externally owned integer - the value to be manipulated

    * @since 2.8

    * @param aSettingText	Text at top of setting pane

    * @param aSettingNumber		Number at top left (if present)

    * @param aControlType			Determines the type constructed and how its resource is read

    * @param aEditorResourceId	Editor resource to use in the setting page (if present)

    * @param aSettingPageResourceId		Setting Page to use (if present)

    * @param aQueryValue			reference to a query value object

    * @param aParent reference to the list that created this page.

    * @param aController reference the the application controller

	*/

	CCamContextAwareSettingPage( 

					const TDesC* aSettingText, 

					TInt aSettingNumber, 

					TInt aControlType,

					TInt aEditorResourceId, 

					TInt aSettingPageResourceId, 

					MAknQueryValue& aQueryValue,

                    CAknEnumeratedTextPopupSettingItem& aParent,

                    CCamAppController& aController );

    /**

	* Destructor

    * @since 2.8

	*/

    ~CCamContextAwareSettingPage();

    /**

    * Symbian 2nd phase constructor.

    * @since 2.8

    */

    void ConstructL();

public: // From base class

    /**

    * From CAknSettingPage

    * Called when the state of the list box changes.

    * Used to update the Cba when the list box is navigated.

    * @since 2.8

    */

    void UpdateSettingL();

    /**

    * From CAknSettingPage

    * Processes events from the softkeys. Responds to EAknSoftkeyOk and EAknSoftkeyBack

    * to accept or cancel the pop-up.

    * @since 2.8

    * @param aCommandId	Event Id from the soft-key

    */

    void ProcessCommandL( TInt aCommandId );

    /**

    * From CAknSettingPage

    * Puts up a constructed dialog. Part of the non-waiting API calls.    

    * Activity to perform as soon as the setting page is displayed

    * @since 2.8

    * @return Whether check succeeded

    */

    TBool PostDisplayCheckL();

private:

    /**

    * Called when the setting value is to be previewed

    * @since 2.8

    * @param aPtr pointer to the object that called the timer

    * @return Error code

    */

    static TInt PreviewSettingChange( TAny* aPtr );

private: // data

    // Used to retrieve the settings value for the currently

    // highlighted list item.

    CAknEnumeratedTextPopupSettingItem& iParent;

    // Used to determine whether a particular setting value is

    // enabled or disabled for selection.

    CCamAppController& iController;

    // Used to perform the preview setting change

    CPeriodic* iTimer;

    // the current value of the setting item

    TInt iCurrentVal;

	};

#endif // CAMCONTEXTAWARESETTINGITEM_H

// End of File