remotestoragefw/gsplugin/inc/rsfwgsremotedrivesettingscontainer.h
branchRCL_3
changeset 20 1aa8c82cb4cb
parent 0 3ad9d5175a89
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/remotestoragefw/gsplugin/inc/rsfwgsremotedrivesettingscontainer.h	Wed Sep 01 12:15:08 2010 +0100
@@ -0,0 +1,249 @@
+/*
+* 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