/*
* Copyright (c) 2002-2005 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:  The control container (view) of the settings list view
*
*/


#ifndef CRSFWGSPLUGINDRIVESETTINGSCONTAINER_H
#define CRSFWGSPLUGINDRIVESETTINGSCONTAINER_H

// INCLUDES
#include    <akncheckboxsettingpage.h>
//#include    "rsfwgsplugin.h"


// FORWARD DECLARATIONS
//class CGSListBoxItemTextArray;
class CRsfwGsPluginSettingsList;
class CRsfwGsSettingsData;
class CRsfwMountMan;
class CAknView;
class CRsfwMountEntry;


// CLASS DECLARATION

/**
*  CRsfwGsPluginDriveSettingsContainer container class
*  container class for Remote drive settings view
*
*  @lib rsfwgsplugin.dll
*  @since Series 60 3.1
*/
class CRsfwGsPluginDriveSettingsContainer : public CCoeControl, 
                                            MEikListBoxObserver,
                                            MCoeForegroundObserver
                                            
    {
    public: // Constructors and destructor

         /**
        * Constructor.
        */
        CRsfwGsPluginDriveSettingsContainer(CAknView* aView);


        /**
        * By default Symbian 2nd phase constructor is private.
        * @param aRect gives the correct TRect for construction
        * @param aModel for the model
        */
        void ConstructL( const TRect& aRect, 
                         CRsfwMountMan* aMountMan );


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

    public: // From CCoeControl
    
        /**
        * See CCoeControl.
        */
        TInt CountComponentControls() const;
        
        /**
        * See CCoeControl.
        */
        CCoeControl* ComponentControl( TInt aIndex ) const;
        
        /**
        * See CCoeControl.
        */
        TKeyResponse OfferKeyEventL( 
            const TKeyEvent& aKeyEvent, TEventCode aType );
            
        /**
        * See CCoeControl.
        */
        void SizeChanged();
        
        /**
        * See CCoeControl.
        */
        void Draw(const TRect& aRect) const;
       
        /**
        * See CCoeControl
        */
        void HandleResourceChange( TInt aType );

        /**
         * Gets help context
         */
        void GetHelpContext( TCoeHelpContext& aContext ) const;

        /**
         * See CCoeControl
         */
        void FocusChanged(TDrawNow aDrawNow);
        
    public: // MCoeForegroundObserver

        /** Handles the drive list view coming to the foreground. */
        void HandleGainingForeground();
        /** Handles the drive list view going into the background. */
        void HandleLosingForeground();
     
        
    public:
    
        /**
        * Edit currently focused item on settings list. called from UI
        */
        void EditCurrentItemL();
        
        /**
        * See MEikListBoxObserver
        */
        void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType);
        
        /**
        * Prepare a Remote drive with given name for editing
        * @param aRemoteDriveName reference to the remote drive to be edited
        */
        void PrepareRemoteDriveForEditingL(const TDesC& aRemoteDriveName);
        
        /**
        * Prepare the a new remote drive with default values with given name
        * @param aRemoteDrive name reference to the new remote drive name
        */
        void PrepareRemoteDriveNewDefaultL(TDesC& aRemoteDriveName);
        
              
        /**
        * Called by the UI when back button is pressed, to perform needed steps
        * @return ETrue if settings list is allowed to close
        */
        TBool IsExitProcessingOKL(); 
        
        /**
        * Save current drive settings
        */        
        void SaveSettingsL();
        
        /*
        * Return the name of current set in iData
        * @return TDes reference to current set
        */
        TDes& GetCurrentRemoteDriveName();

      
        void HandleResourceChangeManual(TInt aType);
      
    private: // Most of these methods perform operations using iData
    
        /**
        * Sets the title pane text with given discriptor
        * @param aTitleText text to be shown on title pane
        */
        void SetTitlePaneTextL( const TDesC& aTitleText ) const;
        
        /**
        * Finds out whether compulsory items are filled
        * @return ETrue if compulsory items are filled
        */
        TBool AreCompulsoryItemsFilled();
        
        /**
        * Display a query dialog to user that compulsory settings are not
        * filled, and if user wants to delete the settings
        * @return ETrue if user wants to delete the settings
        */
        TBool DisplayDeleteOrDontSaveDialogL();
        
        /**
        * Update a remote drive if it already exist or create it if it doesnt exist
        * @param aShowDialog if false then possible error notes won't be shown
        * @return ETrue if save procedure goes ok
        */
        TBool SaveOrCreateAndSaveRemoteDriveL(TBool aShowDialog);
        
        /**
        * Deletes the remote drive if it exist in the Central Repository
        */
        void DeleteRemoteDriveIfExistL();
        
        /**
        * Load Remote drive names with trap, useful when list doesnt have anything
        * @param Reference to setting ids
        * @return CDesCArray remote drives
        */
      	CDesCArray* LoadRemoteDriveNamesL();  
   
        /**
        * See if the remote drive setting under edit was changed
        * @param Reference to the current mount conf 
        * @return ETrue if something has been changed
        */   	
      	TBool DataChanged(const CRsfwMountEntry* aCurrentData);   
      	
      	/**
        * Check whether some other drive (some other drive letter) already uses this name
        * @param aRemoteDriveNamereference the remote drive name
        * @param aDriveLetter the drive letter
        * @return ETrue if remote drive exist with given name
        */
        TBool IsRemoteDriveNameConflictL(TDesC& aRemoteDriveName, const TDesC& aDriveLetter);

        /**
        * Returns ETrue if the address (URL) for a remote drive is valid
        * Calls RsfwMountUtils API
        * @since S60 3.2
        * @param aFriendlyName remote drive friendly name
        */
        TBool IsDriveAddressValidL(const TDesC& aDriveAddress);
            
    private: // data
        
        // CRsfwGsPluginSettingsList owned
      	CRsfwGsPluginSettingsList* iSettingList;        
  
      	// Pointer to settings data owned
      	CRsfwGsSettingsData* iData;
      	
      	  // Pointer to the application view, not owned
     	 CAknView* iView; // not owned
      	    	
    	// model, not owned	
      	CRsfwMountMan*           iMountMan; 
    };


#endif  // CRSFWGSPLUGINDRIVESETTINGSCONTAINER_H

// End of File