/*

* Copyright (c) 2006 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:  AppLauncherForCSXH class declaration

*

*/

#ifndef INC_APPLAUNCHERFORCSXH_H_HEADER_INCLUDED_BC03B1F7

#define INC_APPLAUNCHERFORCSXH_H_HEADER_INCLUDED_BC03B1F7

#include <e32std.h> 

#include <apgtask.h> 

class TApaTask;

const TInt KMaxParamLength = 32;

const TInt KMaxVSAPrefix = 32;

const TInt KMaxVSAScheme = 88;

const TInt KBackSlashLength = 1;

/**

 *  AppLauncherForCSXH 

 *  This class implements launching applications from help

 *  @since S60 v3.2

 */

class AppLauncherForCSXH 

    {

    public:

/** 

*  @function NewL

*  @since S60 3.2

*  Construct a AppLauncherForCSXH 

*  and return a pointer to the created object

*  @return a AppLauncherForCSXH Pointer 

*/

    static AppLauncherForCSXH* NewL();

/** 

*  @function ~AppLauncherForCSXH

*  @since S60 3.2

*  Destroy the object and release all memory objects

*/    

      ~AppLauncherForCSXH();

/** 

*  @function LaunchAppL

*  @since S60 3.2

*  Launches Application

*  @param aUrl  - Buffer which contains iformation about Application Uid,MessageId, ViewID 

*         aCurrentUrl - Currently displayed file path info

*  @return ETrue, if Application Launches Successfully, EFalse otherwise	

*/      

      TBool LaunchAppL(const TDesC& aUrl,const TDesC& aCurrentUrl); 

/** 

*  @function LaunchBrowserNGL

*  @since S60 3.2

*  Launches BrowserNG Application

*  @param aUrl  - external hyperlink info.

*  @return ETrue, if Application Launches Successfully, EFalse otherwise	

*/      

      void LaunchBrowserNGL(const TDesC& aUrl);     	     	

    private:

/** 

*  @function AppLauncherForCSXH

*  @since S60 3.2

*  Perform the first phase of two phase construction

*/ 

     AppLauncherForCSXH();

/** 

*  @function ConstructL

*  @since S60 3.2

*  Perform the second phase construction of a legacytopicview object

*/     

     void ConstructL();

/** 

*  @function GetAppLaunchModeL

*  @since S60 3.2

*  Get the Mode Application Launch Command / View Switch Architecture

*  @param 	aUrl  - Buffer which contains iformation about Application Uid,MessageId, ViewID 

*   		aCurrentUrl - Currently displayed file path info

*  @return  Mode of Launch

*/    

      TInt GetAppLaunchModeL(const TDesC& aUrl,const TDesC& aCurrentUrl);       

/** 

*  @function LaunchApp

*  @since S60 3.2

*  Launch the Application

*  @param 	aUrl  - Buffer which contains iformation about Application Uid,MessageId, ViewID 

*   		aVSAMode - Etrue for View Switch Architecture - EFalse for Command Launch

*  @return  ETrue, Application Launch Successful, EFalse otherwise

*/      

      TBool LaunchApp(const TDesC& aUrl, TBool aVSAMode = ETrue);

/** 

*  @function LaunchCmdApp

*  @since S60 3.2

*  Launch the Application 

*  @param 	aParamsMode  - ETrue, If Application has to be launched with Message. 

*  @return  ETrue, Application Launch Successful, EFalse otherwise

*/      

      TBool LaunchCmdApp(TBool aParamsMode = ETrue);

/** 

*  @function LaunchCmdAppL

*  @since S60 3.2

*  Launch the Application using Command line APIs with parameters

*  @param 	aParamsMode  - ETrue, If Application has to be launched with Message. 

*  @return  ETrue, Application Launch Successful, EFalse otherwise

*/     

      TBool LaunchCmdAppL(TBool aParamsMode);

  /** 

*  @function GetCmdAppTask

*  @since S60 3.2

*  Launch the Application using Command line APIs with parameters

*  @return  Get the TApaTask of the Launched Application

*/      

      TApaTask GetCmdAppTask();

/** 

*  @function SendMsgToCmdAppTaskL

*  @since S60 3.2

*  Send the Message to the Launched Application

*  @param 	aTask  - TApaTask of the launched Application 

*/      

      void SendMsgToCmdAppTaskL(TApaTask &aTask);

/** 

*  @function HandleFailedAppLauchL

*  @since S60 3.2

*  Gives Information Note if Application Launch Failed.

*/      

      void HandleFailedAppLauchL();

/** 

*  @function HandleAppLauchFromInternetL

*  @since S60 3.2

*  Gives Information Note if user try to Launch the application from the external link

*/      

      void HandleAppLauchFromInternetL();

/** 

*  @function CheckAppLaunchFromInternetL

*  @since S60 3.2

*  Checks wether using is trying to launch the application from  external link

*  @param aCurrentMode - VSA / Cmd

*		  aCurrentUrl  - Currently displayed file path info

*/  

      TInt CheckAppLaunchFromInternetL(TInt aCurrentMode,const TDesC& aCurrentUrl );

/** 

*  @function CheckMsgParams

*  @since S60 3.2

*  Checks wether parameters are Valid / Invalid

*  @param Buffer which contains iformation about Application Uid,MessageId, ViewID 

*  @return EParamsWithMsg / EParamsInvalid / EParamsNoMsg

*/      

      TInt CheckMsgParams(const TDesC& aUrl);

/** 

*  @function CheckMsgParams

*  @since S60 3.2

*  Copies Uid & View Id into Variables

*  @param Buffer which contains information about Application Uid,ViewID 

*/ 

      void ExtractTwoParams(const TDesC& aUrl);

/** 

*  @function ExtractFourParams

*  @since S60 3.2

*  Copies Uid, View Id, MessageId & Message into Variables

*  @param aUrl - Buffer which contains information about Application Uid,ViewID, MessageId &  

*/ 

      void ExtractFourParams(const TDesC& aUrl);     

/** 

*  @function GetUid

*  @since S60 3.2

*  Coverts Buffer Content to TInt

*  @param aUid - Application Uid 

*		  aResult - Application Uid	

*/

      void GetUid(TPtrC aUid, TInt32 &aResult);       

/** 

*  @function SendMsgToBrowserNGL

*  @since S60 3.2

*  Send the Message to the BrowserNG

*  @param aUrl - External Hyper Link

*  @return ETrue MessageSent Successfully, EFalse otherwise

*/      

	  TBool SendMsgToBrowserNGL(const HBufC* aUrl);		

/** 

*  @function StartTimer

*  @since S60 3.2

*  Starts the timer

*  @param aCallBack - Callback function for timer

*/      

	  void StartTimer(TCallBack aCallBack);

/** 

*  @function Timer_Callback_to_TerminateApp

*  @since S60 3.2

*  Timer callback function

*  @param aPtr - AppLauncherForCSXH class pointer

*  @return 0

*/      

      static TInt Timer_Callback_to_TerminateApp(TAny* aPtr);

/** 

*  @function SendMsgToApplication

*  @since S60 3.2

*  SendMessage to BrowserNG Application

*  @return 0

*/     

      TInt SendMsgToApplication();    		 

    private:

	  CPeriodic* iTimer;

	  TInt iCount;

	  TBuf<KMaxFileName> iUrl;      

      TBuf<KMaxParamLength> iParam1;

      TBuf<KMaxParamLength> iParam2;

      TBuf<KMaxParamLength> iParam3;

      TBuf<KMaxParamLength> iParam4;	  

    };    

#endif /* INC_APPLAUNCHERFORCSXH_H_HEADER_INCLUDED_BC03B1F7 */