CAknsSrvChunkLookup Class Reference

class CAknsSrvChunkLookup : public CBase

A class for looking up and creating item definitions stored in the shared memory chunk.

Since
2.0

Inherits from

Public Member Functions
~CAknsSrvChunkLookup()
voidBeginRead()
IMPORT_C voidBeginRender()
voidEndRead()
IMPORT_C voidEndRender()
IMPORT_C CAknsItemDef *LookupAndCreateDefL(const TAknsItemID &)
IMPORT_C voidLookupAndCreateScalableItemL(const TAknsItemID &, const TInt, const TSize &, CFbsBitmap *&, CFbsBitmap *&, TInt &)
CAknsSrvChunkLookup *NewL()
Protected Member Functions
CAknsSrvChunkLookup()
voidConstructL()
CAknsAnimationItemDef *CreateAnimationL(const TAknsItemID &, const TAny *, const TAny *)
CAknsEffectItemDef *CreateEffectL(const TUint8 *, const TBool, const TAny *)
TUint32 CreateEffectL(CAknsEffectItemDef *&, const TUint32, const TAny *, const TAny *, const TBool)
CAknsEffectQueueItemDef *CreateEffectQueueL(const TAknsItemID &, const TAny *, const TAny *)
CAknsEffectParamDef *CreateParameterL(const TUint8 *, const TAny *)
TUint32 CreateParameterL(CAknsEffectParamDef *&, const TUint32, const TAny *, const TAny *)
CAknsItemDef *CreateUnprotectedL(const TAknsItemID &, const TAny *, const TAknsItemType, const TAny *)
voidLookupAndCreateScalableItemUnprotectedL(const TAknsItemID &, const TInt, const TSize &, CFbsBitmap *&, CFbsBitmap *&, TInt &)
Private Member Functions
IMPORT_C TIntReserved()
Inherited Functions
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 Attributes
RMutex iRenderMutex
RChunk iSharedChunk
RSemaphore iWaitSema

Constructor & Destructor Documentation

CAknsSrvChunkLookup()

CAknsSrvChunkLookup()[protected]

Default C++ constructor

~CAknsSrvChunkLookup()

~CAknsSrvChunkLookup()[virtual]

Default C++ destructor.

Member Functions Documentation

BeginRead()

voidBeginRead()

Blocks write access to the shared memory chunk.

Since
2.0

BeginRender()

IMPORT_C voidBeginRender()

Blocks all rendering.

Since
2.8

ConstructL()

voidConstructL()[protected]

Second-phase constructor.

CreateAnimationL(const TAknsItemID &, const TAny *, const TAny *)

CAknsAnimationItemDef *CreateAnimationL(const TAknsItemID &aID,
const TAny *aDefPtr,
const TAny *aBasePtr
)[protected]
Since
3.0

Parameters

const TAknsItemID & aID
const TAny * aDefPtr
const TAny * aBasePtr

CreateEffectL(const TUint8 *, const TBool, const TAny *)

CAknsEffectItemDef *CreateEffectL(const TUint8 *aData,
const TBoolaIsAnimationCommand,
const TAny *aBasePtr
)[protected]
Since
3.0

Parameters

const TUint8 * aData
const TBool aIsAnimationCommand
const TAny * aBasePtr

CreateEffectL(CAknsEffectItemDef *&, const TUint32, const TAny *, const TAny *, const TBool)

TUint32 CreateEffectL(CAknsEffectItemDef *&aDef,
const TUint32aOffset,
const TAny *aDefPtr,
const TAny *aBasePtr,
const TBoolaIsAnimationCommand
)[protected]
Since
3.0

Parameters

CAknsEffectItemDef *& aDef
const TUint32 aOffset
const TAny * aDefPtr
const TAny * aBasePtr
const TBool aIsAnimationCommand

CreateEffectQueueL(const TAknsItemID &, const TAny *, const TAny *)

CAknsEffectQueueItemDef *CreateEffectQueueL(const TAknsItemID &aID,
const TAny *aDefPtr,
const TAny *aBasePtr
)[protected]
Since
3.0

Parameters

const TAknsItemID & aID
const TAny * aDefPtr
const TAny * aBasePtr

CreateParameterL(const TUint8 *, const TAny *)

CAknsEffectParamDef *CreateParameterL(const TUint8 *aData,
const TAny *aBasePtr
)[protected]
Since
3.0

Parameters

const TUint8 * aData
const TAny * aBasePtr

CreateParameterL(CAknsEffectParamDef *&, const TUint32, const TAny *, const TAny *)

TUint32 CreateParameterL(CAknsEffectParamDef *&aDef,
const TUint32aOffset,
const TAny *aDefPtr,
const TAny *aBasePtr
)[protected]
Since
3.0

Parameters

CAknsEffectParamDef *& aDef
const TUint32 aOffset
const TAny * aDefPtr
const TAny * aBasePtr

CreateUnprotectedL(const TAknsItemID &, const TAny *, const TAknsItemType, const TAny *)

CAknsItemDef *CreateUnprotectedL(const TAknsItemID &aID,
const TAny *aDef,
const TAknsItemTypeaType,
const TAny *aBasePtr
)[protected]

Creates an item definition object (or leaves) based on the given item definition structure.

Note that this method does not use the semaphore, and is therefore unprotected.

Since
2.0

Parameters

const TAknsItemID & aIDItem ID of the item.
const TAny * aDefPointer to the definition.
const TAknsItemType aTypeType of the definition.
const TAny * aBasePtrChunk base pointer.

EndRead()

voidEndRead()

Allows write access to the shared memory chunk.

Since
2.0

EndRender()

IMPORT_C voidEndRender()

Allows rendering.

Since
2.8

LookupAndCreateDefL(const TAknsItemID &)

IMPORT_C CAknsItemDef *LookupAndCreateDefL(const TAknsItemID &aID)

Returns item definition object matching the given item ID. Performs lookup for the given item ID and returns an instance of one of the subclasses of CAknsItemDef matching the given ID. If the call is successfull, ownership of the item definition object is transferred to the caller.

Since
2.0
Exceptions:
If construction of the item definition object failed, method leaves with an error code.

Parameters

const TAknsItemID & aIDItem ID to be searched.

LookupAndCreateScalableItemL(const TAknsItemID &, const TInt, const TSize &, CFbsBitmap *&, CFbsBitmap *&, TInt &)

IMPORT_C voidLookupAndCreateScalableItemL(const TAknsItemID &aID,
const TIntaLayout,
const TSize &aLayoutSize,
CFbsBitmap *&aBitmap,
CFbsBitmap *&aMask,
TInt &aMorphing
)

Returns stored scalable bitmaps and optionally its mask if it was stored. The ownership of the returned bitmap (and mask, if any) is transferred to the caller.

Optionally, the caller can give the current copy of the bitmap and mask as aBitmap and aMask parameters. If the currently stored scalable bitmaps have the same handles, they are not re-duplicated. The ownership of the given bitmaps is transferred to chunk lookup.

Since
2.8

Parameters

const TAknsItemID & aIDItem ID to be searched.
const TInt aLayoutThe layout id type for the searhed item.
const TSize & aLayoutSize
CFbsBitmap *& aBitmapCurrent bitmap or NULL. Ownership is transferred. After return, contains the newly duplicated bitmap, or NULL if not found. Ownership is transferred.
CFbsBitmap *& aMaskCurrent mask or NULL. Ownership is transferred. After return, contains the newly duplicated mask, or NULL if not found. Ownership is transferred.
TInt & aMorphing

LookupAndCreateScalableItemUnprotectedL(const TAknsItemID &, const TInt, const TSize &, CFbsBitmap *&, CFbsBitmap *&, TInt &)

voidLookupAndCreateScalableItemUnprotectedL(const TAknsItemID &aID,
const TIntaLayout,
const TSize &aLayoutSize,
CFbsBitmap *&aBitmap,
CFbsBitmap *&aMask,
TInt &aMorphing
)[protected]

Returns stored scalable bitmaps and optionally its mask if it was stored.

Note that this method does not use the semaphore, and is therefore unprotected.

Since
2.8

Parameters

const TAknsItemID & aID
const TInt aLayout
const TSize & aLayoutSize
CFbsBitmap *& aBitmap
CFbsBitmap *& aMask
TInt & aMorphing

NewL()

CAknsSrvChunkLookup *NewL()[static]

SymbianOS two-phased constructor.

Since
2.0
Exceptions:
If the construction fails, the leaves with one of the system wide error codes.

Reserved()

IMPORT_C TIntReserved()[private]

Reserved for future use.

Since
2.0

Member Data Documentation

RMutex iRenderMutex

RMutex iRenderMutex[private]

RChunk iSharedChunk

RChunk iSharedChunk[private]

RSemaphore iWaitSema

RSemaphore iWaitSema[private]