Class CCleanupStackableFont

class CCleanupStackableFont : public CBase;

Description

Wraps a font (CFbsFont) object that can be pushed onto the cleanup stack.

By default, the cleanup stack only handles CBase-derived classes, and untyped (TAny*) objects that can be cleaned up by a simple memory free call. Fonts must also be released, which this class handles automatically in its destructor.

The font is initialised from a resource file, and can be identified by name or UID.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CCleanupStackableFont - Wraps a font (CFbsFont) object that can be pushed onto the cleanup stack.

Members

Defined in CCleanupStackableFont:

• Font()constGets the font stored in this object.
• NewByNameL(TResourceReader &,CWsScreenDevice &)Allocates and constructs a new CCleanupStackableFont.
• NewByNameLC(TResourceReader &,CWsScreenDevice &)Allocates and constructs a new CCleanupStackableFont, leaving it on the cleanup ...
• NewL(TResourceReader &,CWsScreenDevice &)Allocates and constructs a new CCleanupStackableFont.
• NewLC(TResourceReader &,CWsScreenDevice &)Allocates and constructs a new CCleanupStackableFont, leaving it on the cleanup ...
• TakeOwnershipOfFont()Gets the font stored in this object.
• ~CCleanupStackableFont()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

See also:

• CFbsFontFont managed by the font and bitmap server. CFbsFont objects are used for screen...

IMPORT_C static CCleanupStackableFont* NewL(TResourceReader &aReader, CWsScreenDevice &aScreenDevice);

Description

Allocates and constructs a new CCleanupStackableFont.

aReader should be initialised to read a resource of type FONT.

Parameters

TResourceReader &aReader The resource reader to use. CWsScreenDevice &aScreenDevice The screen device.

Return value

CCleanupStackableFont * The CCleanupStackableFont object.

IMPORT_C static CCleanupStackableFont* NewLC(TResourceReader &aReader, CWsScreenDevice &aScreenDevice);

Description

Allocates and constructs a new CCleanupStackableFont, leaving it on the cleanup stack.

aReader should be initialised to read a resource of type FONT.

Parameters

TResourceReader &aReader The resource reader to use. CWsScreenDevice &aScreenDevice The screen device.

Return value

CCleanupStackableFont * Pointer to the CCleanupStackableFont object.

IMPORT_C virtual ~CCleanupStackableFont();

Description

Destructor.

This releases the font. The font is only deleted if its access count is zero (so that no client is using it).

IMPORT_C static CCleanupStackableFont* NewByNameL(TResourceReader &aReader, CWsScreenDevice &aScreenDevice);

Description

Allocates and constructs a new CCleanupStackableFont.

aReader should be initialised to read a resource of type NAMED_FONT.

Parameters

TResourceReader &aReader The resource reader to use. CWsScreenDevice &aScreenDevice The screen device.

Return value

CCleanupStackableFont * Pointer to the CCleanupStackableFont object.

IMPORT_C static CCleanupStackableFont* NewByNameLC(TResourceReader &aReader, CWsScreenDevice &aScreenDevice);

Description

Allocates and constructs a new CCleanupStackableFont, leaving it on the cleanup stack.

aReader should be initialised to read a resource of type NAMED_FONT.

Parameters

TResourceReader &aReader The resource reader to use. CWsScreenDevice &aScreenDevice The screen device.

Return value

CCleanupStackableFont * Pointer to the CCleanupStackableFont object.

IMPORT_C CFbsFont& Font() const;

Description

Gets the font stored in this object.

The caller does not take ownership.

Return value

CFbsFont & The font.

IMPORT_C CFbsFont* TakeOwnershipOfFont();

Description

Gets the font stored in this object.

The caller takes ownership of the returned font.

Return value

CFbsFont * The font.