CEikApplication Class Reference

class CEikApplication : public CApaApplication

The base of all Uikon applications.

CEikApplication builds on CApaApplication, providing a basis for applications working within the framework provided by Uikon. It also contains an interface to the resource file and the document object belonging to the application.

Each Uikon application class is derived from CEikApplication. Application writers must provide at least an implementation of the pure virtual function CreateDocumentL().

The application's resource file can be changed from the default by overriding ResourceFileName().

CEikDocument

Inherits from

Public Member Functions
~CEikApplication()
const TApaAppCaption &AppCaption()
IMPORT_C TFileNameBitmapStoreName()
IMPORT_C voidCapability(TDes8 &)
IMPORT_C voidGetDefaultDocumentFileName(TFileName &)
IMPORT_C CDictionaryStore *OpenIniFileLC(RFs &)
CApaProcess *Process()
IMPORT_C TFileNameResourceFileName()
TInt ResourceFileOffset()
IMPORT_C voidSetToIniFileNameL(TParse &)
Protected Member Functions
CEikApplication()
IMPORT_C CApaDocument *CreateDocumentL(CApaProcess *)
IMPORT_C voidEnsureCaptionIsLocalisedL(const TDesC &)
IMPORT_C voidNewAppServerL(CApaAppServer *&)
IMPORT_C voidPreDocConstructL()
Private Member Functions
IMPORT_C voidCEikApplication_Reserved1()
IMPORT_C voidCEikApplication_Reserved2()
CApaDocument *CreateDocumentL()
voidInitAppNameParserWithPathAndExt(TParse &, const TDesC &, const TDesC &)
Inherited Functions
CApaApplication::AppDllUid()const
CApaApplication::AppFullName()const
CApaApplication::CApaApplication()
CApaApplication::DllName()const
CApaApplication::GenerateFileName(RFs &,TFileName &)
CApaApplication::OpenIniFileL(RFs &)const
CApaApplication::SetAppFileNameRef(const RBuf &)
CApaApplication::~CApaApplication()
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Member Enumerations
enumanonymous { EFlagCaptionCorrectlyLocalised = 0x00000001 }
Protected Attributes
CCoeEnv *iCoeEnv
TInt iResourceFileOffset
Private Attributes
TUint iAppFlags
TApaAppCapabilityBuf *iCapabilityBuf
TApaAppCaption iCaption
CApaProcess *iProcess
TInt iSpare

Constructor & Destructor Documentation

CEikApplication()

IMPORT_CCEikApplication()[protected]

~CEikApplication()

IMPORT_C~CEikApplication()

Member Functions Documentation

AppCaption()

const TApaAppCaption &AppCaption()const [inline]

Gets the caption for this application.

Captions are displayed in the task list.

Application caption.

BitmapStoreName()

IMPORT_C TFileNameBitmapStoreName()const [virtual]

CEikApplication_Reserved1()

IMPORT_C voidCEikApplication_Reserved1()[private, virtual]

CEikApplication_Reserved2()

IMPORT_C voidCEikApplication_Reserved2()[private, virtual]

Capability(TDes8 &)

IMPORT_C voidCapability(TDes8 &aInfo)const [virtual]

Returns the capabilities of the application.

Application capability information is represented by an instance of a TApaAppCapability object wrapped in a packaged modifiable buffer descriptor.

The function is called from a number of places within the application framework.

An implementation of this function is supplied by the UI framework.

CEikApplication

TApaAppCapability

TPckgBuf

Parameters

TDes8 & aInfoA packaged modifiable buffer descriptor (a TPckgBuf), encapsulating a TApaAppCapability object.

CreateDocumentL(CApaProcess *)

IMPORT_C CApaDocument *CreateDocumentL(CApaProcess *aProcess)[protected, virtual]

Creates a document object.

The function is called by the application process when a new document is required. The application process adds the new document to its list of documents.

An implementation of this function is supplied by the UI framework.

A pointer to the newly created document.

CApaProcess::AddNewDocumentL()

Parameters

CApaProcess * aProcessA pointer to the process associated with the application.

CreateDocumentL()

CApaDocument *CreateDocumentL()[private, pure virtual]

EnsureCaptionIsLocalisedL(const TDesC &)

IMPORT_C voidEnsureCaptionIsLocalisedL(const TDesC &aLocalisableResourceFile)[protected]

Parameters

const TDesC & aLocalisableResourceFile

GetDefaultDocumentFileName(TFileName &)

IMPORT_C voidGetDefaultDocumentFileName(TFileName &aDocumentName)const [virtual]

Parameters

TFileName & aDocumentName

InitAppNameParserWithPathAndExt(TParse &, const TDesC &, const TDesC &)

voidInitAppNameParserWithPathAndExt(TParse &aParser,
const TDesC &aPath,
const TDesC &aExt
)const [private]

Parameters

TParse & aParser
const TDesC & aPath
const TDesC & aExt

NewAppServerL(CApaAppServer *&)

IMPORT_C voidNewAppServerL(CApaAppServer *&aAppServer)[protected, virtual]

Parameters

CApaAppServer *& aAppServer

OpenIniFileLC(RFs &)

IMPORT_C CDictionaryStore *OpenIniFileLC(RFs &aFs)const [virtual]

Opens the .ini file associated with the application, constructs the dictionary store object, returns a pointer to it and puts the pointer onto the cleanupstack.

The .ini file must be created, if it does not already exist.

An implementation of this function is supplied by the UI framework.

A pointer to the dictionary store object that represents the application's .ini file.

CEikApplication

Parameters

RFs & aFsHandle to a file server session

PreDocConstructL()

IMPORT_C voidPreDocConstructL()[protected, virtual]

Completes construction of this application object.

The function is called after an instance of a derived class has been successfully created using the ordinal 1 function of the application DLL.

After calling this function, an application can create document objects.

An implementation of this function is supplied by the UI framework.

CEikApplication

Process()

CApaProcess *Process()const [inline]

Gets the managing process.

A pointer to the process object managing this application's documents.

ResourceFileName()

IMPORT_C TFileNameResourceFileName()const [virtual]

ResourceFileOffset()

TInt ResourceFileOffset()const [inline]

Gets the offset value defined for this application's default resource file.

As the resource file offset can also be accessed through iResourceFileOffset, this function should not be needed by any apps.

Offset of a resource file.

SetToIniFileNameL(TParse &)

IMPORT_C voidSetToIniFileNameL(TParse &aParser)const

Parameters

TParse & aParser

Member Enumerations Documentation

Enum anonymous

Enumerators

EFlagCaptionCorrectlyLocalised = 0x00000001

Member Data Documentation

TUint iAppFlags

TUint iAppFlags[private]

TApaAppCapabilityBuf * iCapabilityBuf

TApaAppCapabilityBuf *iCapabilityBuf[private]

TApaAppCaption iCaption

TApaAppCaption iCaption[private]

CCoeEnv * iCoeEnv

CCoeEnv *iCoeEnv[protected]

CApaProcess * iProcess

CApaProcess *iProcess[private]

TInt iResourceFileOffset

TInt iResourceFileOffset[protected]

TInt iSpare

TInt iSpare[private]