/*
* 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:  CMSMultiselectionPopup class definition
*
*/


#ifndef CMSMULTISELECTIONPOPUP_H
#define CMSMULTISELECTIONPOPUP_H

// INCLUDES
#include <AknIconArray.h> // CAknIconArray
#include <aknlistquerydialog.h> //CAknListQueryDialog

// CLASS DECLARATION

/**
 * CMSMultiselectionPopup dialog class
 * @since S60 5.1
 */
NONSHARABLE_CLASS( CMSMultiselectionPopup ) : public CAknListQueryDialog
    {
            
    public: // Constructors and destructor

        /**
         * Two-phased constructor.
         *
         * @since S60 v5.1
         * @param aMediaServerArray, array of servers to show
         * @param aSelectionIndexArray, currently selected servers
         * @return CMSMultiselectionPopup*, the new CMSMultiselectionPopup object
            */
        static CMSMultiselectionPopup* NewL(
                TBool aUploadCapabilitySupport,
                RPointerArray<CCmMediaServerFull>* aMediaServerArray,
                CListBoxView::CSelectionIndexArray* aSelectionIndexArray );

        /**
         * Two-phased constructor.
         *
         * @since S60 v5.1
         * @param aMediaServerArray, array of servers to show
         * @param aSelectionIndexArray, currently selected servers
         * @return CMSMultiselectionPopup*, the new CMSMultiselectionPopup object
            */
        static CMSMultiselectionPopup* NewLC(
                TBool aUploadCapabilitySupport,
                RPointerArray<CCmMediaServerFull>* aMediaServerArray,
                CListBoxView::CSelectionIndexArray* aSelectionIndexArray );
				
        /**
         * Destructor.
         */
        virtual ~CMSMultiselectionPopup();

        /**
         * Updates the list of servers.
         *
         * @since S60 v5.1
         * @param aMediaServer, found server
         */
        void UpdateAndDrawPopupL( CCmMediaServerFull* aMediaServer );

		/**
	     * Handles pointer event on touchscreen
	     *
	     * @param aPointerEvent, touchscreen key event 
	     */
		void HandlePointerEventL ( const TPointerEvent& aPointerEvent );

    protected:

        /**
         * 2nd phase constructor.
         */
        void ConstructL();


    // From base class CAknSelectionListDialog
        /**
         * From CAknSelectionListDialog
         * See base class definition
         */
        void PreLayoutDynInitL();

        /**
         * From CAknSelectionListDialog 
         * See base class definition        
         */
        void  PostLayoutDynInitL();

        /**
         * From CAknSelectionListDialog 
         * See base class definition        
         */
        TKeyResponse  OfferKeyEventL( const TKeyEvent &aKeyEvent,
                                      TEventCode aType );
        /**
         * From CAknSelectionListDialog 
         * See base class definition        
         */
        TBool OkToExitL( TInt aButtonId );

    private:

        /**
         * C++ default constructor.
         */
        CMSMultiselectionPopup(
            TBool aUploadCapabilitySupport,            
            RPointerArray<CCmMediaServerFull>* aMediaServerArray,
            CListBoxView::CSelectionIndexArray* aSelectionIndexArray );


        /**
         * Loads a possibly skinned icon and adds it to icon array
         *
         * @since S60 v5.1
         * @param CAknIconArray, array of icons
         * @param MAknsSkinInstance, skin instance
         * @param TDesC, reference to icon file
         * @param TAknsItemID, skinned icon id
         * @param TInt, bitmap id
         * @param TInt, bitmap mask id
         */
        void AppendIconToArrayL( CAknIconArray* aArray,
                                 MAknsSkinInstance* aSkin,
                                 const TDesC& aMbmFile,
                                 const TAknsItemID& aID,
                                 TInt aBitmapId,
                                 TInt aMaskId ) const;

        /**
         * Sets the list of servers for the listbox.
         * @since S60 v5.1
         */
        void AppendMediaServersL();

        /**
         * Creates listbox item string
         * @since S60 v5.1
         * @param aServer, server info
         * @return HBufC*, listbox item
         */
        HBufC* CreateListBoxItemLC( const CCmMediaServerFull* aServer );

    // Enumerations
    
        // icons indexes for the listbox
        enum TIconList
            {
            ECheckedBox = 0,
            EUnCheckedBox,
            EUploadCapability,
            EIconLast
            };

    private: // data

        /**
         * Dialog control item
         */
        CEikListBox*                        iListBox;           // not owned

        /**
         * Indicates if upload capability is needed
         */
        TBool                               iUploadCapabilitySupport;
        
        /**
         * Media servers
         */
        RPointerArray<CCmMediaServerFull>*  iServers;           // not owned

        /**
         * Previously selected indexes
         */
        CArrayFix<TInt>*                    iPreviousSelection; // not owned
    };

#endif // CMSMULTISELECTIONPOPUP_H

// End of File