// Copyright (c) 1997-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 __APADEF_H__

#define __APADEF_H__

#if !defined(__E32BASE_H__)

#include <e32base.h>

#endif

// comand line tokens

/**

@internalComponent

*/

const TUint KApaCommandLetterOpen='O';

/**

@internalComponent

*/

const TUint KApaCommandLetterCreate='C';

/**

@internalComponent

*/

const TUint KApaCommandLetterRun='R';

/**

@internalComponent

*/

const TUint KApaCommandLetterBackground='B';

/**

@internalComponent

*/

const TUint KApaCommandLetterViewActivate='V';

/**

@internalComponent

*/

const TUint KApaCommandLetterRunWithoutViews='W';

/**

@internalComponent

*/

const TUint KApaCommandLetterBackgroundAndWithoutViews='A';

/** Defines the command codes used to indicate the way an application is to be 

launched.

@publishedAll 

@released

@see CApaCommandLine */

enum TApaCommand

	{

	/** The application is to open the document specified on the command line. */

	EApaCommandOpen,

	/** The application is to create the document specified on the command line. */

	EApaCommandCreate,

	/** The application is to run and open the last used document. */

	EApaCommandRun,

	/** The application is to open the last used document and to run in the background. */

	EApaCommandBackground,

	/** Reserved for future use. */

	EApaCommandViewActivate,

	/** The application is to run without views.

	This should NOT be used for view based applications. */

	EApaCommandRunWithoutViews,

	/** The application is to run in the background and viewless mode */

	EApaCommandBackgroundAndWithoutViews

	};

/**

@publishedAll 

@released

*/

const TInt KApaMaxAppCaption=0x100;	// Default name is a file name, so the same limit is used

// TApaAppCaption is the current language name of the app (for task lists, dialogs etc)

/** Defines a modifiable buffer descriptor to contain the caption or the short caption 

for an application. 

@publishedAll 

@released */

typedef TBuf<KApaMaxAppCaption> TApaAppCaption; 

/**

@internalComponent

*/

const TInt KApaMaxCommandLine=0x100;	

/**

@internalComponent

*/

typedef TBuf<KApaMaxCommandLine> TApaCommandLine;

/**

@internalComponent

*/

const TInt KApaMaxAppFileName=0x10;	// Length of App's filename without path or extension (not it's caption)

/**

@internalComponent

*/

typedef TBuf<KApaMaxAppFileName> TApaAppFileName;

/** Maximum length of an application group name.

@publishedAll 

@released

@see TApaAppGroupName */

const TInt KApaMaxAppGroupName=0x10; // Length of App's logical groupname

/** An application group name.

This is a name that allows applications to be categorized, for instance "Games" 

or "Utilities". 

@publishedAll 

@released */

typedef TBuf<KApaMaxAppGroupName> TApaAppGroupName;

/** The hexadecimal value of the 2nd UID that identifies a DLL as being an ASCII UI 

application. In .mmp files, the hexadecimal number is explicitly inserted 

as the first value following the UID keyword. 

@publishedAll 

@deprecated */

const TInt KAppUidValue8 = 0x1000006c;

/** The 2nd UID that identifies a DLL as being an ASCII UI application. 

@publishedAll 

@deprecated */

const TUid KUidApp8={KAppUidValue8};

/** The hexadecimal value of the 2nd UID that defines a DLL as being a Unicode 

UI application. In .mmp files, the hexadecimal number is explicitly inserted 

as the first value following the UID keyword.

@publishedAll 

@released

@see KAppUidValue */

const TInt KAppUidValue16 = 0x100039CE;

/** The 2nd UID that defines a DLL as being a Unicode UI application.

@publishedAll 

@released

@see KUidApp */

const TUid KUidApp16={KAppUidValue16};

//

// 2nd Uid for app doc files

/**

@publishedAll 

@deprecated

*/

const TUid KUidAppDllDoc8={268435565}; 

/**

@publishedAll 

@released

*/

const TUid KUidAppDllDoc16={0x10003A12};

/** The UID encoded in a TPictureHeader that identifies a picture as a door (for 

ASCII builds). 

@publishedAll 

@deprecated

*/

const TUid KUidPictureTypeDoor8={268435537};

/** The UID encoded in a TPictureHeader that identifies a picture as a door (for 

Unicode builds).

@publishedAll 

@released

@see KUidPictureTypeDoor */

const TUid KUidPictureTypeDoor16={0x10003A33};

//

// Uid's for streams in stream dictionaries

/**

@publishedAll 

@deprecated

*/

const TUid KUidSecurityStream8={268435661};

/**

@publishedAll 

@released

*/

const TUid KUidSecurityStream16={0x10003A40};

/**

@publishedAll 

@deprecated

*/

const TUid KUidAppIdentifierStream8={268435593}; // stream containing a TApaAppIdentifier

/**

@publishedAll 

@released

*/

const TUid KUidAppIdentifierStream16={0x10003A34};

#ifdef _UNICODE

/** The type-independent 2nd UID that identifies a DLL as being a UI application.

@publishedAll 

@released

@see KUidApp16

@see KUidApp8 */

#define KUidApp KUidApp16

/** The type-independent hexadecimal value of the 2nd UID that identifies a DLL as 

being a UI application.

@publishedAll 

@released

@see KAppUidValue16

@see KAppUidValue8 */

#define KAppUidValue KAppUidValue16 //lint !e1923 supress could become const variable

/**

@publishedAll 

@released

*/

#define KUidAppDllDoc KUidAppDllDoc16

/** The type independent UID encoded in a TPictureHeader that identifies a picture 

as a door.

@publishedAll 

@released

@see KUidPictureTypeDoor16

@see KUidPictureTypeDoor8

@see TPictureHeader

@see TApaModelDoorFactory::NewPictureL() */

#define KUidPictureTypeDoor KUidPictureTypeDoor16

/**

@publishedAll 

@released

*/

#define KUidAppIdentifierStream KUidAppIdentifierStream16

/**

@publishedAll 

@released

*/

#define KUidSecurityStream KUidSecurityStream16

#else

/** The type independent 2nd UID that defines a DLL as being a UI application.

@see KUidApp16

@see KUidApp8 */

#define KUidApp KUidApp8

/** The type independent hexadecimal value of the 2nd UID that defines a DLL as 

being a UI application.

@see KAppUidValue16

@see KAppUidValue8 */

#define KAppUidValue KAppUidValue8

#define KUidAppDllDoc KUidAppDllDoc8

/** The type independent UID encoded in a TPictureHeader that identifies a picture 

as a door.

@see KUidPictureTypeDoor16

@see KUidPictureTypeDoor8

@see TPictureHeader

@see TApaModelDoorFactory::NewPictureL() */

#define KUidPictureTypeDoor KUidPictureTypeDoor8

#define KUidAppIdentifierStream KUidAppIdentifierStream8

#define KUidSecurityStream KUidSecurityStream8

#endif

const TUid KUidFileEmbeddedApplicationInterfaceUid={0x101f8c96};

#endif