/*

* Copyright (c) 2002 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: 

*         Handling thumbnail save/retrieve operations and making these

*         operations synchronous

*

*/

#ifndef __CBCARDTHUMBNAILHANDLER_H__

#define __CBCARDTHUMBNAILHANDLER_H__

//  INCLUDES

#include <e32base.h>

#include <MPbkThumbnailOperationObservers.h>

// FORWARD DECLARATIONS

class MPbkThumbnailOperation;

class CPbkThumbnailManager;

class CPbkContactEngine;

class CPbkContactItem;

class CFbsBitmap;

// CLASS DECLARATION

/**

 * Class for handling thumbnail save/retrieve operations and making these

 * operations synchronous

 */

NONSHARABLE_CLASS(CBCardThumbnailHandler) : 

        public CBase, 

        private MPbkThumbnailGetObserver, 

        private MPbkThumbnailSetObserver,

        private MPbkThumbnailGetImageObserver

	{

    public: // Constructors and destructor

        /**

         * Creates a new BCard thumbnail handler.

         * @param aEngine Contact engine

         */

        static CBCardThumbnailHandler* NewL(CPbkContactEngine& aEngine);

        /**

         * Destructor. 

         */

        ~CBCardThumbnailHandler();

    private: // Constructors

        CBCardThumbnailHandler();

        void ConstructL(CPbkContactEngine& aEngine);

    public: // Interface

        /**

         * Saves the given 8bit descriptor to the given contact item

         * as thumbnail.

         *

         * @param aContactItem  Contact item where the thubmbnail is stored

         * @param aSource       Source thumbnail to store; a 8bit descriptor 

         *                      containing the image.

         */

        void SaveThumbnailL(CPbkContactItem& aContactItem, const TDesC8& aSource);

        /**

         * Gets the thumbnail from the contact.

         *

         * @param aContactItem  Contact item where the thumbnail is fetched.

         * @return              The thumbnail image of the contact as a

         *                      8bit descriptor.

         */

        const TDesC8& GetThumbnailL(CPbkContactItem& aContactItem);

        /**

         * Check if the given contact has an inserted thumbnail.

         *

         * @param aContactItem  Contact item to check for thumbnail existence.

         */

        TBool HasThumbnail(const CPbkContactItem& aContactItem) const;

    private: // From MPbkThumbnailGetImageObserver

        void PbkThumbnailGetImageComplete

            (MPbkThumbnailOperation& aOperation, CPbkImageDataWithInfo* aImageData);

        void PbkThumbnailGetImageFailed

            (MPbkThumbnailOperation& aOperation, TInt aError);

    private: // From MPbkThumbnailGetObserver

        void PbkThumbnailGetComplete(

            MPbkThumbnailOperation& aOperation, CFbsBitmap* aBitmap);

        void PbkThumbnailGetFailed

            (MPbkThumbnailOperation& aOperation, TInt aError);

    private: // From MPbkThumbnailSetObserver

        void PbkThumbnailSetComplete

            (MPbkThumbnailOperation& aOperation);

        void PbkThumbnailSetFailed

            (MPbkThumbnailOperation& aOperation, TInt aError);

    private: // Implementation

        TBool IsAlreadyExportableL(CPbkContactItem& aContactItem);

        HBufC8* GetThumbnailBitmapL(CPbkContactItem& aContactItem);

        void ProcessError(MPbkThumbnailOperation& aOperation, TInt aError);

        void ProcessComplete(MPbkThumbnailOperation& aOperation);

    private: // Data

		/// Own: phonebook thumbnail manager

        CPbkThumbnailManager* iManager;

		/// Own: asynchronous thumbnail operation

        MPbkThumbnailOperation* iThumbOperation;

		/// Own: image data

        CPbkImageDataWithInfo* iImageData;

		/// Own: the bitmap

        CFbsBitmap* iBitmap;

		/// Own: thumbnail bitmap jpeg descriptor

        HBufC8* iImageBlob;

		/// Own: active scheduler

        CActiveSchedulerWait iWait;

		/// Own: error code

        TInt iError;

    };

#endif // __CBCARDTHUMBNAILHANDLER_H__

// End of File