examples/ForumNokia/S60_3rd_Edition_TextMTM_Example/modules/Install/src/TxtViewerStarter.h

/*
* ============================================================================
*  Name     : ViewerStarter from MuiuMsgEditorLauncher.h
*  Part of  : msgavkon\muiu
*
*  Description:
*  Static class which launches editor application (provided editor
*  conforms to \msgeditor architecture.
*
*
*  Version:
*
*  Copyright (C) 2002 Nokia Corporation.
*  This material, including documentation and any related 
*  computer programs, is protected by copyright controlled by 
*  Nokia Corporation. All rights are reserved. Copying, 
*  including reproducing, storing,  adapting or translating, any 
*  or all of this material requires the prior written consent of 
*  Nokia Corporation. This material also contains confidential 
*  information which may not be disclosed to others without the 
*  prior written consent of Nokia Corporation.
*
* ============================================================================
*/


#ifndef __MUIUMSGEDITORLAUNCHER_H__
#define __MUIUMSGEDITORLAUNCHER_H__


//  INCLUDES
#include <apparc.h>
#include <msvapi.h>
#include <msvids.h>
#include <MTCLBASE.H>   // TMsvPartList

// CONSTANTS
const TUid KUidMsvEditorParameterValue = {0x100014AA};


// FORWARD DECLARATIONS (These declarations are for class ViewerStarter)
class CEikDocument;
class CCommandAbsorbingControl;
class TEditorParameters;


// CLASS DECLARATION

class TEditorParameters
    {
    public:
        inline TEditorParameters();
        inline TEditorParameters( const TEditorParameters& aParams );
        inline void ExternalizeL( RWriteStream& aStream ) const;
        inline void InternalizeL( RReadStream& aStream );
    public:
        TMsvId  iId;
        TInt    iFlags;
        TMsvPartList iPartList;
        TMsvId iDestinationFolderId;
        TUid    iSpecialAppId;
    };

enum TEditorFlags
    {
    EMsgReadOnly = 0x00010,
    EMsgSwitch = 0x00020,          // Internal
    EMsgEditorChanged = 0x00040,       // Internal
    EMsgCreateNewMessage = 0x00080,
    EMsgLaunchEditorThenWait = 0x00100,
    EMsgLaunchEditorEmbedded = 0x00200,
    EMsgForwardMessage = 0x01000,
    EMsgReplyToMessageSender = 0x02000,
    EMsgReplyToMessageAll = 0x04000,
    EMsgCreateMessageToService = 0x08000,
    EMsgEditNewMessage = 0x10000,
    EMsgPreviewMessage = 0x20000,
    EMsgCreateDuplicate = 0x40000,
    EMsgUnreadMessage = 0x80000,
    EMsgFirstFreeEditorSpecificFlag = 0x100000
    };

inline TEditorParameters::TEditorParameters()
:   iId( KMsvNullIndexEntryId ),
    iFlags( 0 ),
    iPartList( 0 ),
    iDestinationFolderId( KMsvNullIndexEntryId ),
    iSpecialAppId( TUid::Uid(0) )
    {}

inline TEditorParameters::TEditorParameters( const TEditorParameters& aParams )
:   iId( aParams.iId ),
    iFlags( aParams.iFlags ),
    iPartList( aParams.iPartList ),
    iDestinationFolderId( aParams.iDestinationFolderId ),
    iSpecialAppId( aParams.iSpecialAppId )
    {}

inline void TEditorParameters::ExternalizeL( RWriteStream& aStream ) const
    {
    aStream.WriteInt32L( iId );
    aStream.WriteInt32L( iFlags );
    aStream.WriteInt32L( iPartList );
    aStream.WriteInt32L( iDestinationFolderId );
    }
inline void TEditorParameters::InternalizeL( RReadStream& aStream )
    {
    iId = aStream.ReadInt32L();
    iFlags = aStream.ReadInt32L();
    iPartList = aStream.ReadInt32L();
    iDestinationFolderId = aStream.ReadInt32L();
    }


// CLASS DECLARATION

class ViewerStarter
    {
    public:

        IMPORT_C static CMsvOperation* LaunchEditorApplicationL(
            CMsvSession& aSession,
            TUid aMtmType,
            TRequestStatus& aStatus,
            const TEditorParameters& aParams,
            const TDesC& aAppName,
            const TDesC8* aAddtionalParams = NULL );

        IMPORT_C static CMsvOperation* LaunchEditorApplicationL(
            CMsvSession& aSession,
            TUid aMtmType,
            TRequestStatus& aStatus,
            const TEditorParameters& aParams,
            const TDesC& aAppName,
            const TDesC8& aProgressPack,
            const TDesC8* aAddtionalParams = NULL );

    private:
        static CMsvOperation* LaunchEditorApplicationEmbeddedL(
            CMsvSession& aSession,
            TUid aMtmType,
            TRequestStatus& aStatus,
            const TEditorParameters& aParams,
            const TDesC& aAppName,
            const TDesC8& aProgressPack );

        static CMsvOperation* LaunchEditorApplicationStandAloneL(
            CMsvSession& aSession,
            TUid aMtmType,
            TRequestStatus& aStatus,
            const TEditorParameters& aParams,
            const TDesC& aAppName,
            const TDesC8& aProgressPack,
            const TDesC8* aAddtionalParams,
            TBool aLaunchThenWait );

        static TUid DiscoverL( const TEditorParameters aParams );

        static TBool TryMatchL(  const TEditorParameters aParams, const TApaAppServiceInfo aInfo, TUid& aAppUid  );

    };


class MsvUiEditorUtilities
    {
    public:
        IMPORT_C static HBufC* ResolveAppFileNameL( TUid aAppUid );
    };


class MsgEditorServiceResolver
        {
        public:
        static TUid DiscoverL( const TEditorParameters aParams, TUid aMtmType );

        static TBool TryMatchL(  const TEditorParameters aParams, TUid aMtmType, const TApaAppServiceInfo aInfo, TUid& aAppUid  );
        };



#endif // __MSGEDITORLAUNCHER_H__

// End of file

---