/*

* Copyright (c) 2005-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:  Declaration of CGSAccBaseView class

*

*/

#ifndef CGSACCBASEVIEW_H

#define CGSACCBASEVIEW_H

#include <AccessorySettings.h>

#include <aknview.h>

#include <eikclb.h>

class CGSAccBaseContainer;

class CGSAccessoryPluginModel;

/**

*  Base class for GS Accessory settings views.

*

*  @since S60 3.1

*/

class CGSAccBaseView : public CAknView, public MEikListBoxObserver

    {

public:

    /**

    * Destructor.

    */

    virtual ~CGSAccBaseView();

protected: // From CAknView

    /**

    * @see class CAknView.

    */

    void HandleCommandL( TInt aCommand );

    /**

    * @see class CAknView.

    */

    void DoActivateL(

        const TVwsViewId& aPrevViewId,

        TUid aCustomMessageId,

        const TDesC8& aCustomMessage );

    /**

    * @see class CAknView.

    */

    void DoDeactivate();

protected: // From MEikMenuObserver

    /**

    * @see class MEikMenuObserver.

    */

    void DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane );

protected: // From MEikListBoxObserver

    /**

    * @see class MEikListBoxObserver.

    */

    void HandleListBoxEventL(

        CEikListBox* aListBox,

        TListBoxEvent aEventType );

protected:

    /**

    * First phase constructor.

    *

    * @param aModel Data model for reading and writing settings.

    */

    CGSAccBaseView( CGSAccessoryPluginModel& aModel );

    /**

    * Updates listbox items value.

    *

    * @param aItemId Item which is updated.

    */

    void UpdateListBoxL( TInt aItemId );

    /**

    * Show a selection dialog with content specified in resources.

    *

    * @param aDlgResourceID Resource id for the dialog resource.

    * @param aItemsResourceID Resource id for the list of available items.

    * @param aCurrentSelectionIndex Index of the item which should be selected

    * initially. On return, contains the selection made by the user.

    * @return ETrue if the new value should be saved.

    */

    TBool ShowRadioButtonSettingsPageL(

        TInt aDlgResourceID,

        TInt aItemsResourceID,

		TInt& aCurrentSelectionIndex ) const;

    /**

    * Show a selection dialog with content given as parameter.

    *

    * @param aDlgResourceID Resource id for the dialog resource.

    * @param aItemArray Array of available items.

    * @param aCurrentSelectionIndex Index of the item which should be selected

    * initially. On return, contains the selection made by the user.

    * @return ETrue if the new value should be saved.

    */

    TBool ShowRadioButtonSettingsPageL(

        TInt aDlgResourceID,

		const MDesCArray& aItemArray,

		TInt& aCurrentSelectionIndex ) const;

    /**

    * Show the default profile selection dialog and store user selection.

    *

    * @param aProfileIdKey Cenrep key where the default profile is stored.

    * @param aListBoxId Identifies list box to update if profile is changed.

    */

    void ChangeDefaultProfileL(

        TInt aProfileKey,

        TInt aListBoxId );

    /**

    * Change automatic answer mode setting.

    *

    * @param aAutoAnswerKey Cenrep key where the auto answer mode is stored.

    * @param aListBoxId Identifies list box to update if mode is changed.

    * @param aSettingPage Show the setting page if ETrue, otherwise just flip

    * the value.

    */

    void ChangeAutoAnswerModeSettingL(

        TInt aAutoAnswerKey,

        TInt aListBoxId,

        TBool aUseSettingPage );

    /**

    * Change lights mode setting.

    *

    * @param aAccMode Identifies the accessory mode to change the light

    * setting for.

    * @param aAccSetting Identifies the light setting to change.

    * @param aListBoxId Identifies list box to update if mode is changed.

    * @param aSettingPage Show the setting page if ETrue, otherwise just flip

    * the value.

    */

    void ChangeLightModeSettingL(

        TAccMode aAccMode,

        TInt aAccSetting,

        TInt aListBoxId,

        TBool aUseSettingPage );

protected:

    /**

    * Functionality for creating a container. Called by DoActivateL().

    * Implemented by sub-class.

    */

    virtual void NewContainerL() = 0;

    /**

    * Handle selection of list box.

    * Called by HandleListBoxEventL

    *

    * @param aSelectedItem Currently selected item.

    */

    virtual void HandleListBoxSelectionL( TInt aSelectedItem ) = 0;

private:

    /**

    * Basic idea behind General Settings plugin framework is that view objects

    * stay alive even when they are not active, but container objects do not.

    * Create new container.

    */

    void CreateContainerL();

    /**

    * Delele the container.

    */

    void DestroyContainer();

protected: // data

    /** Data model. */

    CGSAccessoryPluginModel& iModel;

    /**

    * Container. Own.

    * Sub-classes are responsible for creating object of correct type.

    */

    CGSAccBaseContainer* iContainer;

    };

#endif // CGSACCBASEVIEW_H