// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 // which accompanies this distribution, and is available

 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 //

 #ifndef __VIEWCLI_H__

 #define __VIEWCLI_H__

 #include <e32base.h>

 #include <gdi.h>

 #include <vwsdef.h>

 //

 // Forward declarations.

 //

 class RVwsSession;

 class CVwsSessionEventHandler;

 class MVwsAppStarter;

 class MVwsSessionWrapperObserver

 /**

 The MVwsSessionObserver specifies an interface through which server events to be handled by the owner of

 a client session are notified

 @publishedAll 

 @deprecated

 */

 //@internalTechnology @released

 	{

 public:	

 	/**

 	 * Handles the view event aEvent for a view added through the client session being observed.

 	 * Handles events for all the views added by the client.

 	 */

 	virtual void HandleViewEventL(const TVwsViewEvent& aEvent)=0;

 	};

 class CVwsSessionWrapper : public CBase

 /**

 The CVwsSessionWrapper class mediates access to the view server client session which it creates, and wraps in

 support for notification of server events. A session observer will be called back with server events if

 it maintains an outstanding request for asynchronous event notification.

 @publishedPartner 

 @released 

 */

 //@internalTechnology @released

 	{

 public:	

 	IMPORT_C static CVwsSessionWrapper* NewL();

 	IMPORT_C static CVwsSessionWrapper* NewLC();

 	IMPORT_C static CVwsSessionWrapper* NewL(MVwsSessionWrapperObserver& aObserver);

 	IMPORT_C static CVwsSessionWrapper* NewLC(MVwsSessionWrapperObserver& aObserver);

 	IMPORT_C ~CVwsSessionWrapper();

 	IMPORT_C static TInt StartViewServer(MVwsAppStarter& aAppStarter);

 	IMPORT_C TInt ShutdownViewServer();

 	IMPORT_C TInt AddView(const TVwsViewId& aViewId);

 	IMPORT_C TInt RemoveView(const TVwsViewId& aViewId) const;

 	IMPORT_C TInt SetSystemDefaultView(const TVwsViewId& aViewId,TInt aMode);

 	IMPORT_C TInt SetSystemDefaultView(const TVwsViewId& aViewId);

 	IMPORT_C TInt ActivateView(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage);

 	IMPORT_C TInt ActivateViewViaViewEvent(const TVwsViewIdAndMessage& aViewIdAndMessage);

 	IMPORT_C TInt RequestCustomMessage(TDes8& aMessageBufPtr) const;

 	IMPORT_C void QueueAsyncRequest();

 	IMPORT_C TInt StartApp(TUid aAppToStart);

 	IMPORT_C TInt DeactivateActiveView();

 	IMPORT_C TInt DeactivateActiveViewIfOwnerMatch();

 	IMPORT_C TInt NotifyNextDeactivation(const TVwsViewId& aViewId);

 	IMPORT_C TInt NotifyNextDeactivation();

 	IMPORT_C TInt NotifyNextActivation(const TVwsViewId& aViewId);

 	IMPORT_C TInt NotifyNextActivation();

 	IMPORT_C TInt SetDefaultView(const TVwsViewId& aViewId,TInt aMode) const;

 	IMPORT_C TInt SetDefaultView(const TVwsViewId& aViewId) const;

 	IMPORT_C TInt GetSystemDefaultView(TVwsViewId& aViewId);

 	IMPORT_C TInt CreateActivateViewEvent(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage);

 	IMPORT_C TInt SetClientRequestTimeOut(TTimeIntervalMicroSeconds32 aDuration);

 	IMPORT_C TInt SetServerEventTimeOut(TTimeIntervalMicroSeconds32 aDuration);

 	IMPORT_C TInt EnableServerEventTimeOut(TBool aEnable);

 	IMPORT_C TInt CheckSourceOfViewSwitch(TBool& aResult,const TSecurityPolicy& aSecurityPolicy,const char* aDiagnostic);

 	IMPORT_C TInt EnableServerBlankScreen(TBool aEnable);

 	IMPORT_C TInt EnableExternalViewSwitches(TBool aEnable);

 	IMPORT_C void ActivateView(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage, TRequestStatus& aStatus);

 	IMPORT_C TInt SetCrossCheckUid(const TUid& aCrossCheckUid);

 	IMPORT_C TInt SetWindowBackgroundColor(const TRgb& aBgColor);

 public:	

 	/**

 	@internalComponent

 	@released

 	*/

 	IMPORT_C TInt ActivateView(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage, TInt aCustomControl);

 	/**

 	@internalComponent

 	@released

 	*/

 	IMPORT_C void ActivateView(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage, TRequestStatus& aStatus, TInt aCustomControl);

 	/**

 	@internalComponent

 	@released

 	*/IMPORT_C TInt CreateActivateViewEvent(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC8& aCustomMessage, TInt aCustomControl);

 	/**

 	@internalComponent

 	@released

 	*/

 	IMPORT_C TInt GetCurrentActiveViewInSystem(TVwsViewId& aActiveViewId);

 private:

 	CVwsSessionWrapper();

 	CVwsSessionWrapper(MVwsSessionWrapperObserver& aObserver);

 	void ConstructL();

 	TInt CheckCreateViewServerSession();

 	TBool IsSchedulerRunning();

 private:

 	RVwsSession* iVwsSession;

 	CVwsSessionEventHandler* iViewEventHandler;

 	MVwsSessionWrapperObserver* iObserver;

 	};

 //

 // Panic.

 //

 /**

 @internalComponent

 */

 enum TVwsPanic

 	{

 	EVwsCreateScheduler=1,

 	EVwsThreadRename

 	};

 /**

 @internalComponent

 */

 GLREF_C void Panic(TVwsPanic aPanic);

 /**

 Server thread start.

 @internalComponent

 */

 GLDEF_C TInt ViewServerThreadStart(TAny* aPtr);

 /**

 @internalComponent

 */

 struct SVwsCommandLine

 	{

 	MVwsAppStarter* iAppStarter;

 	};

 #endif