/*
* Copyright (c) 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:  Definition for multiselection setting class
*
*/


#ifndef C_MSRULEMULTISELECTIONSETTING
#define C_MSRULEMULTISELECTIONSETTING

// INCLUDES
#include "mssettingitems.h"

// FORWARD DECLARATIONS
class CSelectionItemList;
class CCmSqlPropertyContainer;

// CLASS DECLARATION

/**
 * CMSRuleMultiSelectionSetting class. This class is used when
 * server list is modified
 *
 * @Since S60 5.1
*/
NONSHARABLE_CLASS( CMSRuleMultiselectionSetting ): public CMSTextSettingItem
    {
    public:

        /**
         * Two-phased constructor.
         *
         * @since S60 5.1
         * @param aIdentifier, resource identifier
         * @param aFirstPopupItemResource, first list item text resource id
         * @param aAnyItemTextRestource, 'any' item text resource
         * @param aMetadataArray, metadata list
         * @param aArray, selection list
         * @param aItemTextResource, item text resource when multiple
         *                           items selected
         * @param aText, dummy parameter - needed in item creation
         * @return None
         */
        static CMSRuleMultiselectionSetting* NewL( TInt aIdentifier,
                                    TInt aTitleResource,
                                    TInt aFirstPopupItemResource,
                                    TInt aAnyItemTextResource,
                                    CCmSqlPropertyContainer* aMetadataArray,
                                    RArray<TInt>* aArray,
                                    TInt aItemTextResource,
                                    TDes& aText);

        /**
         * Two-phased constructor.
         *
         * @since S60 5.1
         * @param aIdentifier, resource identifier
         * @param aFirstPopupItemResource, first list item text resource id
         * @param aAnyItemTextRestource, 'any' item text resource
         * @param aMetadataArray, metadata list
         * @param aArray, selection list
         * @param aItemTextResource, item text resource when multiple
         *                           items selected
         * @param aText, dummy parameter - needed in item creation
         * @return None
         */
        static CMSRuleMultiselectionSetting* NewLC( TInt aIdentifier,
                                    TInt aTitleResource,
                                    TInt aFirstPopupItemResource,
                                    TInt aAnyItemTextResource,
                                    CCmSqlPropertyContainer* aMetadataArray,
                                    RArray<TInt>* aArray,
                                    TInt aItemTextResource,
                                    TDes& aText);
                                    
        /**
        * Destructor.
        */
        virtual ~CMSRuleMultiselectionSetting();

        /**
         * Creates item list and updates listbox text
         */
        void CreateItemListL();

    protected:

// From base class CAknSettingItem

        /**
         * From CAknSettingItem
         * See base class definition
        */
        void EditItemL( TBool aCalledFromMenu );

    private:

        /**
         * Creates selection list for setting page
         *
         * @since S60 5.1
         * @param None
         * @return None
         */
        void CreateSelectionItemListL();

        /**
         * Appends selected items to the list
         *
         * @since S60 5.1
         * @param None
         * @return None
         */
        void AppendSelectedItemsToListL();

        /**
         * Sets setting item text
         *
         * @since S60 5.1
         * @param None
         * @return None         
         */
        virtual void SetSettingItemTextL();

    private:

        /**
         * Performs the first phase of two phase construction.
         *
         * @since S60 5.1
         * @param aIdentifier, resource identifier
         * @param aFirstPopupItemResource, first list item text resource id
         * @param aAnyItemTextRestource, 'any' item text resource
         * @param aMetadataArray, metadata list
         * @param aArray, selection list
         * @param aItemTextResource, item text resource when multiple
         *                           items selected
         * @param aText, dummy parameter - needed in item creation
         * @return None
         */         
        CMSRuleMultiselectionSetting(
            TInt aIdentifier,
            TInt aTitleResource,
            TInt aFirstPopupItemResource,
            TInt aAnyItemTextResource,
            CCmSqlPropertyContainer* aMetadataArray,
            RArray<TInt>* aArray,
            TInt aItemTextResource,
            TDes& aText
            );

        /**
         * Performs the second phase construction.
         */
        void ConstructL();

    private:

        /**
         * selected item count
         */
        TInt                                iSelectedItemCount;
        /**
         * item text resource
         */
        TInt                                iItemTextResource;

        /**
         * setting item text
         */
        TDesC&                              iText;
        /**
         * item array for selection dialog
         */
        CSelectionItemList*                 iItemArray;     // owned
        /**
         * Server name string (external set)
         */
        HBufC16*                            iSettingText;   // owned
        /**
         * list of selected items
         */
         RArray<TInt>*                      iList;          // not owned
        /**
         * array of metadata items
         */
         CCmSqlPropertyContainer*           iMetadataArray; // not owned
        /**
         * title resource for multiselection dialog
         */
        TInt                                iTitleResource;
        /**
         * first item resource for multiselection dialog
         */
        TInt                                iFirstPopupItemResource;
        /**
         * secondary text resource
         */
        TInt                                iAnyItemTextResource;
        /**
         * Last selected item index
         */
        TInt                                iSelectedItemIndex;
    };

#endif // C_MSRULEMULTISELECTIONSETTING

// End of File