// under the terms of "Eclipse Public License v1.0"

// apacmdln.h

#ifndef __APACMDLN_H__

#include <e32base.h>	// class CBase

#include <apadef.h>		// enum TApaCommand

To start an application, passed a CApaCommandLine object to the RApaLsSession::StartApp() method.

This class is often referred to as a command line and contains:

the name of an application EXE to be launched, a document name,

To start an application, startup parameters are set on the CApaCommandLine object that is 

then externalized into a stream and attached to a new RProcess object. These parameters 

are then used to re-populate a new CApaCommandLine object inside the process by 

EikStart::RunApplication() and used to bootstrap the launching application.

class CApaCommandLine : public CBase

	// Creates an empty command line object

	// Specify how the application is to be started (see TApaCommand in apadef.h)

	IMPORT_C void SetCommandL(TApaCommand aCommand);

	IMPORT_C TApaCommand Command() const;

	// Launch the application associated with the mime-type of the document file

	IMPORT_C void SetDocumentNameL(const TDesC& aDocName);

	IMPORT_C TPtrC DocumentName() const;

	IMPORT_C void SetFileByHandleL(const RFile& aFile);

	IMPORT_C void GetFileByHandleL(RFile& aFile) const;

	// Launch the application explicitly named

	IMPORT_C void SetExecutableNameL(const TDesC& aAppName);

	IMPORT_C TPtrC ExecutableName() const;

	// Additional application execution arguments (added to the tail if the command line)

	IMPORT_C void SetTailEndL(const TDesC8& aTailEnd);

	IMPORT_C TPtrC8 TailEnd() const;

	// Set the process id of the application being the conceptual parent.

	// The child process will be closed down automatically when the parent is.

	IMPORT_C void SetParentProcessId(TProcessId aProcessId);

	IMPORT_C TProcessId ParentProcessId() const;

	// Starting the application on a specific screen

	IMPORT_C void SetDefaultScreenL(TInt aDefaultScreenNumber);

	IMPORT_C TInt DefaultScreen() const;

	IMPORT_C TBool IsDefaultScreenSet() const;

	// Managed order of applications' window groups.

	// A child applicatoin's windows will always be kept in front of the parent's windows.

	IMPORT_C void SetParentWindowGroupID(TInt aParentWindowGroupID);

	IMPORT_C TInt ParentWindowGroupID() const;

	// Process environment-slot for public use. These can be used for passing parameters 

	// to the starting application. However, use of the EndTail should be prefered.

	IMPORT_C static TInt NumberOfEnvironmentSlotsForPublicUse();

	IMPORT_C static TInt EnvironmentSlotForPublicUse(TInt aIndex);

public:	// Internal

	// Set opaque data sent to the application being started

	IMPORT_C void SetOpaqueDataL(const TDesC8& aOpaqueData);

	IMPORT_C TPtrC8 OpaqueData() const;

	// Getting/setting the CApaCommandLine to/from process environment-slots

	IMPORT_C void SetProcessEnvironmentL(RProcess& aProcess) const;

	IMPORT_C static TInt GetCommandLineFromProcessEnvironment(CApaCommandLine*& aCommandLine);

	// operations to support passing memory-allocation failure settings in to applications

	IMPORT_C void SetDebugMemFailL(TInt aDebugMemFail);

	IMPORT_C TInt DebugMemFail() const;

	// operations to support the instrumentation (i.e. profiling) of application startup

	IMPORT_C void SetAppStartupInstrumentationEventIdBaseL(TInt aEventIdBase);

	IMPORT_C TInt AppStartupInstrumentationEventIdBase() const;

	void DoGetCommandLineFromProcessEnvironmentL();

	TInt DoGetParametersFromCommandLineString(const TDesC& aCmdLine);

	static HBufC* NameOfExecutable(const TDesC& aCmdLine, TInt& aEndDocNameOffset);

	static TPtrC StripQuotes(const TDesC& aDes);

	void SetServerDifferentiatorL(TUint aServerDifferentiator);

	enum	// for internal use only

	RBuf iDocumentName;

	RBuf iExecutableName;

	RBuf8 iOpaqueData;

	RBuf8 iTailEnd;

#endif // __APACMDLN_H__