/*

* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  test aknpictographinterface.h

                      akniconsrvclient.h

                      akniconutils.h

                      akninternaliconutils.h

*

*/

#ifndef C_AKNICONUTILSEXT_H

#define C_AKNICONUTILSEXT_H

#include <akniconutils.h>

#include <eikenv.h>

#include <akniconobserver.h>

class CTestIconProvider : public CBase,

                          public MAknIconFileProvider

    {

public:

    /**

    * 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.

    *

    * @param 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.

    * @param aType Icon file type.

    */

    virtual void RetrieveIconFileHandleL( RFile& aFile,

            const TIconFileType aType );

    /**

    * 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.

    */

    virtual void Finished();

private: // data

    /**

     * Not Own

     */

    CEikonEnv* iEnv;

    };

class CTestIconObserver : public CBase,

                          public MAknIconObserver

    {

    public:

        /**

        * This is an abstract class for specifying an interface for 

        * receiving notifications when an icon's frame buffer has been updated.

        * An object of derived class implementing this interface should be registered

        * for a given icon to the AknIcon framework using 

        * function AknIconUtils::SetObserver().

        * 

        * AknIcon framework calls this function whenever the frame buffer of the observed icon

        * changes. This observer mechanism is mainly useful in animated icons cases.

        * The observer e.g. can redraw the icon on the screen when the frame of the animated 

        * icon has changed.

        *

        * @since 2.8

        * @param aBitmap bitmap or mask of the icon

        */

        virtual void BitmapChanged( CFbsBitmap* aBitmap );

    };

#endif // C_AKNICONUTILSEXT_H