/*
* 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:   Setting item which, when clicked on, opens
*                 to another settings page.
*
*/



#ifndef CALENNESTEDSETTINGITEM_H
#define CALENNESTEDSETTINGITEM_H

// INCLUDES
#include <aknsettingitemlist.h>

// FORWARD DECLARATIONS

// CLASS DECLARATION
/**
 * CCalenNestedSettingItem - a setting item which will open a new settings
 * page when clicked on.
 */
class CCalenNestedSettingItem : public CAknSettingItem
    {
    public:  // Constructors and destructor
        /**
         * Constructor. Ownership of aSettings and its contents remains with the
         * caller, however during CompleteConstructionL the array will have
         * its contents removed. Ownership of the removed objects will be transferred.
         */
        CCalenNestedSettingItem( TInt aId,
                                 RPointerArray<CAknSettingItem>& aUnownedSettings,
                                 const TDesC& aTitle );

        /**
         * Destructor.
         */
        ~CCalenNestedSettingItem();

    protected:  // From base classes
        /**
         * From CAknSettingItem.
         * Called when the user clicks on the setting item.
         */
        void EditItemL( TBool aCalledFromMenu );

        /**
         * From CAknSettingItem.
         * Called by the framwork to complete construction.
         */
        void CompleteConstructionL();

    private:  // Data
        /**
         * Settings to be shown in the new settings page. Neither the array
         * or the contents are owned by this class.
         */
        RPointerArray<CAknSettingItem>& iUnownedSettings;

        /**
         * Settings to be shown in the new settings page. This contains pointers
         * moved from the array passed in on construction.
         */
        RPointerArray<CAknSettingItem> iOwnedSettings;

        /**
         * View id of the view which launched the nested setting.
         * We go back to this view after the setting item editing has been completed.
         */
        TVwsViewId iParentView;

        /**
         * Title of the new page. Should be the plugin name. Not owned.
         */
        const TDesC& iTitle;
    };

#endif // CALENNESTEDSETTINGITEM_H

// End of File