/*
* 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 Location setting.*
*/



#ifndef CAMLOCATIONSETTINGPAGE_H
#define CAMLOCATIONSETTINGPAGE_H

//  INCLUDES
#include <aknsettingpage.h>
#include "MCamAppController.h"

// FORWARD DECLARATIONS
class MCamAppController;
class CCamLocationSettingContainer;
class MAknQueryValue;

// CLASS DECLARATION

/**
*  Setting page for the location control. This setting page is customised
*  so that it contains a custom control and not the editor control
*  supplied by CAknSettingPage. The base class doesn't allow for custom
*  controls to be used in settings pages, so this class provides this
*  functionality.
*
*  @since 2.8
*/

class CCamLocationSettingPage : public CAknSettingPage
	{
public: // Constructors, etc.
	/**
	* Construct the quality setting page
    * @since 2.8
    * @param aMode                  The current capture mode
    * @param aSettingTitleText	    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 aController            reference tothe application controller
	*/
	CCamLocationSettingPage( TCamCameraMode aMode, 
                           TDesC& aSettingTitleText,
                           TInt aSettingNumber, 
                           TInt aControlType,
                           TInt aEditorResourceId, 
                           TInt aSettingPageResourceId,
                           MAknQueryValue& aQueryValue,
                           MCamAppController& aController );

    /**
	* Destructor
    * @since 2.8
	*/
    ~CCamLocationSettingPage();

    /**
    * Symbian 2nd phase constructor.
    * @since 2.8
    */
    void ConstructL();

public: // Functions from base classes

    /**
    * From CAknSettingPage
    * Called when the state of the quality control changes.
    * Used to preview the new setting value
    * @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();

    /**
    * From CAknSettingPage
    * Used to inform the setting item that a new value has been selected
    * @since 2.8
    */
    void SelectCurrentItemL();

    /**
    * From CCoeControl
    * Standard Constructs the control from the resource
    * @since 2.8
    * @param	aReader	The resource reader
    */
    void ConstructFromResourceL( TResourceReader& aReader );

    /**
    * From CCoeControl
    * Standard CCoeControl routine to return the number of component controls
    * @since 2.8
    * @return the number of component controls
    */
	TInt CountComponentControls() const;

    /**
    * From CCoeControl
    * Standard CCoeControl routine to return the control at a given index
    * @since 2.8
    * @param anIndex index at which to return control
    * @return the control at the given index
    */ 
    CCoeControl* ComponentControl( TInt anIndex ) const;

    /**
    * From CCoeControl
    * Used the draw the setting page
    * @since 2.8
    * @param aRect the invalid rect to draw
    */ 
    void Draw( const TRect& aRect ) const;

    /**
    * From CCoeControl
    * Called when the size of the setting page changes
    * @since 2.8
    */ 
    void SizeChanged();

    /**
    * From CCoeControl
    * Used to handle key events
    * @since 2.8
    * @param aKeyEvent the key event to handle
    * @param aType the type of key event
    * @return whether the key was handled
    */ 
    TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, TEventCode aType );

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 inform the setting item of a change in setting page
    MAknQueryValue& iQueryValue;
    // the custom control (quality container ) used in this setting page
    CCamLocationSettingContainer* iLocationContainer;
    // reference to the application controller
    MCamAppController& iController;
    // the current camera mode
    TCamCameraMode iMode;
    // Used to perform the preview setting change
    CPeriodic* iTimer;
    // the setting item
    TInt iSettingItemId;
    // the current value of the setting item
    TInt iCurrentVal;
	};

#endif // CAMLOCATIONSETTINGPAGE_H

// End of File
