/*
* 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:    Slideshow settings dialog implementation
*
*/





#ifndef SHWSLIDESHWSETTINGSLIST_H
#define SHWSLIDESHWSETTINGSLIST_H

//  EXTERNAL INCLUDES
#include <eiklbo.h>					// for MEikListBoxObserver
#include <aknsettingitemlist.h>		// for CAknSettingItem
#include <MMGFetchVerifier.h>		// for MMGFetchVerifier
#include <caf/content.h>			// for ContentAccess::CContent
#include <caf/data.h>				// for ContentAccess::CData

//  INTERNAL INCLUDES


//  FORWARD DECLARATIONS
class CRepository;
class CShwSettingsModel;
class TShwEffectInfo;

/**
 * @author Loughlin Spollen
 * The slide show settings list - contained with the settings dialog
 * @lib shwslideshowengine.lib
 * @internal reviewed 08/06/2007 by Kimmo Hoikka
 */
NONSHARABLE_CLASS (CShwSlideShowSettingsList) : public CAknSettingItemList,
								 			    public MMGFetchVerifier
	{
	public:  // Constructors and destructor
		/**
        * Symbian default constructor.
        * @param aShwSettings setting values for music state, default path 
        *		 and track default effect ECOM plugin UID and effect index 
        *		 within the effect ECOM plugin
        */
		static CShwSlideShowSettingsList* NewL(CShwSettingsModel& aShwSettings);
	
		/**
		* Destructor
		*/
		~CShwSlideShowSettingsList();
													 
	public: //from CAknSettingItemList
	
		// @ref CAknSettingItemList::CreateSettingItemL
		CAknSettingItem* CreateSettingItemL(TInt aIdentifier);
		
		// @ref CAknSettingItemList::HandleListBoxEventL
		void HandleListBoxEventL(CEikListBox* aListBox,
				       			  	  TListBoxEvent aEventType);

	public: 

		/**
		* Update the list box.
		* @param The List box item index to be updated
		* @param Whether the event originated from a key press or menu command
		*/	
        void UpdateListBoxL(TInt aListBoxIndex, TInt aKeyEvent = EFalse);
		
		/**
		* Update the music on/off control and the coupled
		* music file name.
		*/	
		void UpdateMusicStateL();

		/**
		* Update the music file name and path
		*/			
		void UpdateMusicFileNamePathL();
		
		/**
		* Update the transition delay between images
		*/	
		void UpdateTransDelayL();

		/**
		* Update the transition effect between images
		*/	
		void UpdateTransEffectL(TBool aKeyEvent);


    private:	
		/**
        * C++ default constructor.
        * @param aShwSettings setting values for music state, default path 
        *		 and track default effect ECOM plugin UID and effect index 
        *		 within the effect ECOM plugin
        */
		CShwSlideShowSettingsList(CShwSettingsModel& aShwSettings);

		/**
		* 2nd stage constructor
		*/
        void ConstructL();
	
	
	private: 

	
		/**
        * Launch MGFetch for filename fetch
        */
		void FetchFileNameFromUserL();		
		
		/**
        * Remove the music settings and set the default setting
        * values
        */
		void ResetMusicDefaultsL();

		
		/**
        * Validate the DRM rights for the music track file
		* @return TBool ETrue if valid for track selection
        */
		TBool ValidateDRML();

		/**
        * Show error note
		* @param aResourceId resource id of text string
		*/
		void ShowErrorNoteL(TInt aResourceId) const;


		/**
        * Check if iFileName exists
		* @return ETrue if exists
        */
		TBool FileNameExistsL();		
		
		/**
        * Change the state of the music enabled setting
        */
		void SetMusicStateL(TBool aNewMusicState);
		
		/**
        * Change the direction/order of slide show play
        */
		void SetPlayDirectionL(TBool aNewPlayDirection);
		
    	/**
    	* Ask for user confirmation of a given query using a dialog
    	* @param aQueryResourceId The query resource string ID
    	* @return True if the user confirmed the query, otherwise false
    	*/
    	TBool ConfirmationQueryL(TInt aQueryStrId);

        /**
        * Check if the only files that can be played are DRM protected
        * @return ETrue if the only file that can be played are DRM protected
        *       otherwise EFalse
        */
        TBool PlayOnlyDRMProtectedFilesL();
        
        /**
        * Read the values present in rss file and do required conversion
        * @param aResourceId resource string ID
        * @return converted value
        */
        HBufC* ReadLBufStringL(const TInt aResourceId);

	private: // from MMGFetchVerifier

		/**
		* @ref MMGFetchVerifier::VerifySelectionL
		*/
        TBool VerifySelectionL(const MDesCArray* aSelectedFiles);

	private: //data
	
		class CShwTransEffectEnumPopupSettingItem;
		class CShwTransEffectBinaryPopupSettingItem;
		// Add our own setting page and item to fix
		// EEBD-79UL8Q - "no naviscroll support in slideshow settings"
		class CShwSliderSettingPage;
		class CShwSliderSettingItem;
		
		// Music On/Off Setting
		TBool iMusicState;
		
		//Play direction
		TBool iPlayDirection;
		
		// Number of transition effects
		TUint iEffectsCount;
		
		// Array of Transition effects
		RArray<TShwEffectInfo> iEffects;
		
		// Music filename Setting
		RBuf iMusicNamePath;
		
		// The transition delay between images
		TInt iTransDelay;
				
		// Not Owned: Slideshow settings 
		CShwSettingsModel& iShwSettings;
        		
        // Owned: The Central Repository
        CRepository* iRepository;
        
	};

#endif // SHWSLIDESHWSETTINGSLIST_H