Collapse all Symbian^3 Application Developer Library

MAknIconFileProvider Class Reference

class MAknIconFileProvider

The purpose of this class is for clients to provide opened file handles to icon files, which reside in private directories, where AknIcon server has no access.

MIF file is always generated, when building icons with MifConv tool. The corresponding MBM file is generated only if there are bitmap icons amongst the source icons.

Public Member Functions
	~MAknIconFileProvider ()
void	Finished ()
void	RetrieveIconFileHandleL ( RFile &, const TIconFileType )

Public Member Enumerations
enum	TIconFileType { EMbmFile = 0, EMifFile = 1 }

Constructor & Destructor Documentation

~MAknIconFileProvider()

~MAknIconFileProvider

(

)

[inline, virtual]

Destructor.

Member Functions Documentation

Finished()

void

Finished

(

)

[pure virtual]

With this method, AknIcon framework informs that it does not use this MAknIconFileProvider instance any more. After this call, it is ok to delete the object. This can be implemented simply e.g. by deleting self in this callback. Normally, this callback is invoked when the icon in question is deleted. Note, however, that if the same MAknIconFileProvider instance is supplied in multiple CreateIcon calls, then it must be accessible by AknIcon framework until it has signalled a matching amount of these callbacks.

RetrieveIconFileHandleL(RFile &, const TIconFileType)

void	RetrieveIconFileHandleL	(	RFile &	aFile,
			const TIconFileType	aType
		)	[pure virtual]

Returns an open file handle to the icon file. This method should leave if an icon file with specified type does not exist. That may be the case e.g. with MBM file, if there are no bitmap icons.

Note! RFs::ShareProtected must be called to the RFs instance used for opening the file.

Parameters

RFile & aFile	Icon file should be opened in this file handle, which is an empty file handle, when the AknIcon framework calls this method. The AknIcon framework takes care of closing the file handle after having used it.
const TIconFileType aType	Icon file type.

Member Enumerations Documentation

Enum TIconFileType

Enumerators

EMbmFile = 0
EMifFile = 1