--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/messagingfw/msgurlhandler/urlhandler/inc/MsgUrlHandlerApp.H	Wed Nov 03 22:41:46 2010 +0530
@@ -0,0 +1,278 @@
+// Copyright (c) 2001-2009 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 API definition for the classes 
+// CMsgUrlHandlerApplication, CMsgUrlHandlerAppView, 
+// CMsgUrlHandlerAppUi, CMsgUrlHandlerDocument.
+// 
+//
+
+/**
+ @file
+*/
+
+#ifndef __MSGURLHANDLERAPP_H__
+#define __MSGURLHANDLERAPP_H__
+
+#include <coeccntx.h>
+
+#include <eikappui.h>
+#include <eikapp.h>
+#include <eikdoc.h>
+
+#include <uikon.hrh> 
+
+#include <msgurlhandler.rsg>
+
+
+/**
+	@class
+	Dependencies : CEikApplication
+	Comments :	Defines the application's UID and manufactures a new, 
+				blank document.
+	@since 7.0
+*/
+class CMsgUrlHandlerApplication : public CEikApplication
+/**
+@internalComponent
+@released
+*/
+	{
+private: 
+
+/**
+	@fn				CreateDocumentL()
+	Intended Usage	:	This function is inherited from class CApaApplication.
+						This function is called by the UI framework at
+						application start-up. It creates an instance of the
+						document class.
+	@since			7.0
+	@leave		KErrNoMemory.
+	@return			Returns the document class
+ */
+	CApaDocument* CreateDocumentL();
+
+/**
+	@fn				AppDllUid() const
+	Intended Usage	:	The function is called by the UI framework to ask for the
+						application's UID.
+	@since			7.0
+	@return			Returns the apps uid.
+ */
+	TUid AppDllUid() const;
+	};
+
+/**
+	@class
+	Dependencies : CEikAppUi
+	Comments :	This class handles command generated by the menu items, toolbar
+				buttons and shortcut keys. It delegates drawing and screen based
+				interaction to the app view and other controls.
+	@since 7.0
+*/
+class CMsgUrlHandlerAppUi : public CEikAppUi
+/**
+@internalComponent
+@released
+*/
+    {
+
+public:
+
+/**
+	@fn				CMsgUrlHandlerAppUi()
+	Intended Usage	:	Constructor. First phase of two-phase construction method. Does 
+						non-allocating construction.
+	@since			7.0
+ */
+	CMsgUrlHandlerAppUi();
+
+/**
+	@fn				~CMsgUrlHandlerAppUi()
+	Intended Usage	:	Destructor.
+	@since			7.0
+ */
+	~CMsgUrlHandlerAppUi();
+
+private:
+
+/**
+	@fn				ConstructL()
+	Intended Usage	:	Second phase of two-phase construction method. Does any 
+						allocations required to fully construct the object.
+
+						This function is called by Eikon hence no NewL().
+
+						Starts the Idle time active object which calls the callback
+						function. This starts the background task.
+						This background task is encapsulated in the callback function. 
+	@since			7.0
+	@pre 			First phase of construction is complete
+	@post			The object is fully constructed and initialised.
+					The background task has started.
+ */
+    void ConstructL();
+
+/**
+	@fn				ProcessCommandParametersL(TApaCommand aCommand,TFileName& aDocumentName,const TDesC8& aTail)
+	Intended Usage	:	This function is inherirted from class CEikAppUi.
+						Reads and assigns the commandline (i.e the url) from apparc.  
+	@since			7.0
+	@param			aCommand			The shell command sent to the application. 
+	@param			aDocumentName		At call time, the name of the document as specified
+										on the command line. On return, the name for the 
+										file which will be created by the calling framework. 
+	@param			aTail				Command line tail.  
+	@return			Whether the final value of aDocumentName represents an existing file.
+					For this form of the function this is ETrue if the Uikon application 
+					framework needs to open an existing file called aDocumentName. 
+					Otherwise, this will be EFalse if the Uikon application framework 
+					needs to create the file.
+	@pre 			None
+	@post			The commandline is assigned.
+ */
+	TBool ProcessCommandParametersL(TApaCommand aCommand,TFileName& aDocumentName,const TDesC8& aTail);
+
+/**
+	@fn				HandleCommandL(TInt aCommand)
+	Intended Usage	:	Closes the application from the menu item and the shortcut
+						key Ctrl-e.
+	@since			7.0
+	@param			aCommand		A command ID. 
+	@pre 			None
+	@post			Application is closed if the menu item or the shortcut key is used. 
+ */
+	void HandleCommandL(TInt aCommand);	
+
+/**
+	@fn				static TInt IdleConstructCallbackL(TAny* aThis)
+	Intended Usage	:	This is an idle constructor for the callback function.
+						It calls the idle constructor.
+	@since			7.0
+	@param			aThis		Not used 
+	@return			If returned true than the active object is scheduled to run again 
+					later. If returned false than the active object is no longer scheduled 
+					to run. 
+	@pre 			The idle active object has started.
+	@post			Runs the background task.
+ */
+	static TInt IdleConstructCallbackL(TAny* aThis);
+
+/**
+	@fn				IdleConstructL()
+	Intended Usage	:	Idle constructor. Calls the LoadStartPageL function.
+	@since			7.0
+	@pre 			The idle active object has started.
+	@post			Runs the background task.
+ */
+	void IdleConstructL();
+
+/**
+	@fn				LoadStartPageL()
+	Intended Usage	:	If the command line exists than it calls the 
+						LaunchMailEditor function. 
+	@return			void 
+	@pre 			The idle active object is running.
+	@post			calls the LaunchMailEditor function if the command line exists. 
+ */
+	void LoadStartPageL();
+
+/**
+	@fn				LaunchMailEditorL(const TDesC& aUrl)
+	Intended Usage	:	Parses the url (i.e the command line) and 
+						launches the correct mail editor.
+	Error Condition	:	This function leaves with KErrNotFound if the messaging
+						scheme is not found.
+	@since			7.0
+	@leave		KErrNotSupported
+	@param			aUrl		A url descriptor
+	@pre 			None
+	@post			Parses the url and launches the correct mail editor.
+ */
+	void LaunchMailEditorL(const TDesC& aUrl);
+
+private:
+	/** The descriptor buffer that contains the commandline from apparc
+		i.e the messaging url.
+	*/
+	HBufC* iCommandLineFileName;
+
+	/** The Idle active object */
+	CIdle* iIdleConstructor;
+	};
+
+
+/**
+	@class
+	Dependencies : CEikDocument
+	Comments :	Launches the App UI
+	@since 7.0
+*/
+class CMsgUrlHandlerDocument : public CEikDocument
+/**
+@internalComponent
+@released
+*/
+	{
+public:
+
+/**
+	@fn				NewL(CEikApplication& aApp)
+	Intended Usage	:	Static factory constructor. Uses two phase construction and 
+						leaves nothing on the CleanupStack.
+	@since			7.0
+	@leave		KErrNoMemory.
+	@param			aApp		The CEikApplication app
+	@return			A pointer to the newly created CMsgUrlHandlerDocument object. 
+	@pre 			None
+	@post			A fully constructed and initialised CMsgUrlHandlerDocument object.
+ */
+	static CMsgUrlHandlerDocument* NewL(CEikApplication& aApp);
+
+private:
+
+/**
+	@fn				CMsgUrlHandlerDocument(CEikApplication& aApp)
+	Intended Usage	:	Constructor. First phase of two-phase construction method. Does 
+						non-allocating construction.
+	@param			aApp		The CEikApplication app
+	@since			7.0
+ */
+	CMsgUrlHandlerDocument(CEikApplication& aApp);
+
+/**
+	@fn				ConstructL()
+	Intended Usage	:	Second phase of two-phase construction method. Does any 
+						allocations required to fully construct the object.
+	@since			7.0
+	@leave		KErrNoMemory.
+	@pre 			First phase of construction is complete
+	@post			The object is fully constructed and initialised.
+ */
+	void ConstructL();
+
+/**
+	@fn				CEikAppUi* CreateAppUiL()
+	Intended Usage	:	This function is inherited from CEikDocument.
+						Launches the App UI.
+	@since			7.0
+	@leave		KErrNoMemory.
+	@return			Returns a pointer to CEikAppUi  
+	@pre 			App is created
+	@post			None
+ */
+	CEikAppUi* CreateAppUiL();
+	};
+
+
+#endif