/*

* Copyright (c) 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:  

*           Data utility class for UniEditor & MMS related editors and viewers

*

*/

#ifndef __UNIDATAUTILS_H

#define __UNIDATAUTILS_H

//  INCLUDES

#include <apmstd.h>         //TDataType

#include <apgcli.h>         //RApaLsSession

#include <barsc.h>

#include <unimodelconst.h>

#include <cmsvattachment.h> // TMsvAttachmentId

// CONSTANTS

_LIT8( KUniEmptySlide,      "application/X-MmsEmptySlide" );

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CMsgTextUtils;

class CBaseMtm;

class MMsvAttachmentManager;

// CLASS DECLARATION

/**

* CUniDataUtils - Miscellaneous UI indenependent utilities.

*

* @lib UniDataUtils.lib

* @since 3.1

*/

class CUniDataUtils : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Constructor.

        *

        * @since    3.1

        * @param    aFs     IN Fileserver session.

        * @return   Pointer to instance

        */

        IMPORT_C static CUniDataUtils* NewL( RFs& aFs );

        /**

        * Destructor.

        *

        * @since 3.1

        */

        virtual ~CUniDataUtils();

        /**

        * DefaultFileName

        * (e.g. "noname" - no prefix)

        * 

        * @since    3.1

        * @return   Pointer to default file name buffer

        */ 

        inline TPtrC DefaultFileName() const;

        /**

        * EmptyPageString

        * (e.g. "Empty page")

        * 

        * @since    3.1

        * @return   Pointer to "empty page" buffer

        */ 

        inline TPtrC EmptyPageString() const;

        /**

        * CharconvIdToMibIdL

        * Converts between id's.

        * 

        * @since    3.1

        * @param    aCharconvCharsetId  IN charconv id

        * @return   MIB enumeration

        */

        IMPORT_C TUint CharconvIdToMibIdL( TUint aCharconvCharsetId );

        /**

        * MibIdToCharconvIdL

        * Converts between id's.

        * 

        * @since    3.1

        * @param    aMibId  IN MIB enumeration

        * @return   Charconv id

        */

        IMPORT_C TUint MibIdToCharconvIdL( TUint aMibId );

        /** 

        * Gets bytes size of UTF8 formatted text

        *

        * @since    3.1

        * @param aText

        * @return Size of text in bytes

        */

        IMPORT_C static TInt UTF8Size( TPtrC aText );

        /**

        * Gets bytes size of file.

        *

        * @since    3.1

        * @param aFileName

        * @return Size of the file.

        */

        IMPORT_C TInt FileSizeL( const TFileName& aFileName );

        /**

        * Get open file handle for an attachment

        *

        * @since    3.1

        * @param    aMtm    Client MTM

        * @param    aId     Attachment ID

        * @return   Open read-only file handle.

        *           It is callers responsibilty to close the handle.

        */

        IMPORT_C static RFile GetAttachmentFileL( CBaseMtm& aMtm, TMsvAttachmentId aId );

        /**

        * Get the "attachment manager index position" for an attachment.

        *

        * @since    3.1

        * @return "attachment manager index position"

        * @leave  KErrNotFound if attachment is not found from the store

        */

        IMPORT_C static TInt IndexPositionOfAttachmentL(

            MMsvAttachmentManager& aManager,

            TMsvAttachmentId aId );

    protected:

        /**

        * C++ constructor

        * 

        * @since    3.1

        * @param    aFs     IN Fileserver session.

        */

        CUniDataUtils( RFs& aFs );

        /** 

        * ConstructL

        * Symbian OS constructor

        * 

        * @since    3.1

        */

        void ConstructL();

        /** 

        * RegisterDataL

        * Reads data from resources.

        * 

        * @since    3.1

        */

        void RegisterDataL();

        /** 

        * ReadResStringsL

        * Reads strings from resources to internal mimetype arrays.

        * 

        * @since    3.1

        * @param    aResourceFile   IN opened resourcefile

        * @param    aSrcResId   IN resource id to read from

        * @return   Pointer to read string 

        **/

        HBufC* ReadResStringL( const RResourceFile& aResourceFile, TInt aSrcResId );

    protected:  // data

        RFs& iFs;

        CMsgTextUtils* iTextUtils;

        HBufC* iDefaultFileName;

        HBufC* iEmptyPageString;

    };

#include <unidatautils.inl>

#endif   // __UNIDATAUTILS_H

// End of file