williamr@4: // Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@4: // All rights reserved.
williamr@4: // This component and the accompanying materials are made available
williamr@4: // under the terms of "Eclipse Public License v1.0"
williamr@4: // which accompanies this distribution, and is available
williamr@4: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4: //
williamr@4: // Initial Contributors:
williamr@4: // Nokia Corporation - initial contribution.
williamr@4: //
williamr@4: // Contributors:
williamr@4: //
williamr@4: // Description:
williamr@4: // Help Launcher module
williamr@4: // 
williamr@4: //
williamr@4: 
williamr@4: #ifndef __HLPLCH_H__
williamr@4: #define __HLPLCH_H__
williamr@4: 
williamr@4: #if !defined(__APGTASK_H__)
williamr@4: #include <apgtask.h>
williamr@4: #endif
williamr@4: 
williamr@4: #if !defined(__EIKDLL_H__)
williamr@4: #include <eikdll.h>
williamr@4: #endif
williamr@4: 
williamr@4: #if !defined(__WSERV_H__)
williamr@4: #include <w32std.h>
williamr@4: #endif
williamr@4: 
williamr@4: #if !defined(__COEHELP_H__)
williamr@4: #include <coehelp.h>
williamr@4: #endif
williamr@4: 
williamr@4: /** Help application UID. 
williamr@4: @internalComponent
williamr@4: @released
williamr@4: */
williamr@4: const TUid KHlpAppUid={ 0x10005234 };
williamr@4: 
williamr@4: /** UID of window message to send to application. 
williamr@4: @internalComponent
williamr@4: @released
williamr@4: */
williamr@4: const TUid KHlpAppWsMsg={ 0x100055c7 };
williamr@4: 
williamr@4: #ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
williamr@4: 
williamr@4: /** Maximum length of command line to launch application. 
williamr@4: @internalComponent
williamr@4: @released
williamr@4: */
williamr@4: const TInt KMaxCmdLineLength = 512;
williamr@4: 
williamr@4: // resource file name
williamr@4: _LIT(KHelpLauncherResource, "z:\\resource\\apps\\lch.rsc");
williamr@4: 
williamr@4: class CHlpCmdLine : public CBase
williamr@4: /**
williamr@4: @internalComponent
williamr@4: @released
williamr@4: */
williamr@4: 	{
williamr@4: public:
williamr@4: 	static CHlpCmdLine* NewL(CArrayFix<TCoeHelpContext>* aContextList);
williamr@4: 	static CHlpCmdLine* NewLC(CArrayFix<TCoeHelpContext>* aContextList);
williamr@4: 	~CHlpCmdLine();
williamr@4: public:
williamr@4: 	TPtr8 CmdLineL();
williamr@4: private:
williamr@4: 	void BuildCmdLineL();
williamr@4: 	void AddContextL(TCoeHelpContext& aContext);
williamr@4: private:
williamr@4: 	void ConstructL();
williamr@4: 	CHlpCmdLine(CArrayFix<TCoeHelpContext>* aContextList);
williamr@4: private:
williamr@4: 	CArrayFix<TCoeHelpContext>* iContextList;
williamr@4: 	CBufFlat* iCmdLine;
williamr@4: 	};
williamr@4: 	
williamr@4: #endif //SYMBIAN_ENABLE_SPLIT_HEADERS
williamr@4: 
williamr@4: class HlpLauncher
williamr@4: /** Launches the help application.
williamr@4: 
williamr@4: It assumes that such an application is at z:\\Sys\\Bin\\CsHelp.exe
williamr@4: 
williamr@4: @publishedAll
williamr@4: @released
williamr@4: */
williamr@4: 	{
williamr@4: public:
williamr@4: 	IMPORT_C	static void LaunchHelpApplicationL(RWsSession& aWsSession, CArrayFix<TCoeHelpContext>* aContextList);
williamr@4: 	IMPORT_C	static void LaunchHelpApplicationL(RWsSession& aWsSession, TUid aUid);
williamr@4: 	IMPORT_C	static void LaunchHelpApplicationL(RWsSession& aWsSession);
williamr@4: private:
williamr@4: 	static void DoLaunchHelpApplicationL(RWsSession& aWsSession, const TDesC8& aCmdLine);
williamr@4: 	};
williamr@4: 
williamr@4: #endif