/*
* Copyright (c) 2002-2004 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:   This file contains the header file of the CCUIDriveUtils class 
*
*/


#ifndef CUIDRIVEUTILS_H
#define CUIDRIVEUTILS_H

//  INCLUDES
#include <e32base.h>

//  FORWARD DECLARATIONS

namespace SwiUI
{
namespace CommonUI
{

/**
* This class provides functions to launch a common file selection dialog.
* @lib SWInstCommonUI.lib
* @since 3.0
*/
NONSHARABLE_CLASS(CCUIDriveUtils) : public CBase
    {
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        * @param aSize - Size of the package.
        * @param aDriveUnits - Array of available drives as drive units.
        * @param aDriveSpaces - Array of free space on each of the drives in the
        *                       aDriveLetters array.
        */
        static CCUIDriveUtils* NewL( TInt64 aSize,
                                     const RArray<TDriveUnit>& aDriveUnits, 
                                     const RArray<TInt64>& aDriveSpaces);
        
        /**
        * Destructor.
        */
        virtual ~CCUIDriveUtils();


    public: // New functions
        
        /**
        * Show a drive selection dialog. 
        * @since 3.0
        * @param aSelectedDrive - Contains the drive letter that user selected.
        * @return ETrue is user selected a drive, EFalse if user canceled the query.
        */
        TBool ShowSelectionDialogL( TInt& aSelectedDrive );

        /**
        * Function to get info if internal drive is present (phone memory).
        * @since 3.0
        * @return ETrue if yes, EFalse if no.
        */
        TBool IsInternalDrivePresent() const;

        /**
        * Function to get info if memory card is present.
        * @since 3.0
        * @return ETrue if yes, EFalse if no.
        */
        TBool IsCardDrivePresent() const;  
        
        /**
        * Get the free space on phone memory.
        * @since 3.0
        * @return Free space on phone memory.
        */
        TInt64 GetInternalDriveSpace() const;

        /**
        * Get the free space on memory card.
        * @since 3.0
        * @return Free space on memory card.
        */
        TInt64 GetCardDriveSpace() const;       

        /**
        * Get the free space on drive.
        * @since 3.0
        * @param aIndex - Drive index.
        * @return Free space on memory card.
        */
        TInt64 GetDriveSpace( TInt aIndex ) const;      
        
        /**
        * Get array index of the phone memory in the aDriveLetters array.
        * @since 3.0
        * @return Array index of the phone memory.
        */      
        TInt GetInternalDriveIndex() const;

        /**
        * Get array index of the memory card in the aDriveLetters array.
        * @since 3.0
        * @return Array index of the memory card.
        */  
        TInt GetCardDriveIndex() const;        
        
    private:
        
        /**
        * Constructor.
        * @param aSize - Size of the package.
        * @param aDriveUnits - Array of available drives as drive units.
        * @param aDriveSpaces - Array of free space on each of the drives in the
        *                            aDriveLetters array.
        */
        CCUIDriveUtils( TInt64 aSize,
                        const RArray<TDriveUnit>& aDriveUnits, 
                        const RArray<TInt64>& aDriveSpaces);

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

        TInt64 iSize;        
        const RArray<TDriveUnit>& iDriveUnits;        
        const RArray<TInt64>& iDriveSpaces;        

        TInt iInternalArrayIndex;
        TInt iCardArrayIndex;    
    
        TChar iCardDriveLetter;  

        TInt64 iInternalFreeMemory;
        TInt64 iCardFreeMemory;
    };
}
}

#endif      // SWCOMMONUI_H
            
// End of File