/*
* Copyright (c) 2006 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:  Loads thumbnail from contact engine.
*
*/


#ifndef CPHCNTPBKTHUMBNAILLOADER_H
#define CPHCNTPBKTHUMBNAILLOADER_H

#include <e32base.h>
#include <MPbkThumbnailOperationObservers.h>

#include "cphcntthumbnailloaderbase.h"

class MPhoneCntPbkOwner;
class CPhCntContactId;
class MPbkThumbnailOperation;
class CPbkContactItem;
class CPbkThumbnailManager;
class MPbkThumbnailGetObserver;


/**
 *  Loads thumbnail from contact engine.
 *
 *  @lib S60 PhoneCntFinder
 *  @since S60 v3.1
 */
NONSHARABLE_CLASS( CPhCntPbkThumbnailLoader ) : 
    public CPhCntThumbnailLoaderBase,
    private MPbkThumbnailGetObserver
    {
public:
    
    /**
     * Static constructor.
     *
     * @since S60 v3.1
     * @param aOwner Owner of phone book.
     */
    static CPhCntPbkThumbnailLoader* NewL( MPhoneCntPbkOwner& aOwner );

    /**
     * Static constructor.
     *
     * @since S60 v3.1
     * @param aOwner Owner of phone book.
     */
    static CPhCntPbkThumbnailLoader* NewLC( MPhoneCntPbkOwner& aOwner );

    /**
     * Destructor.
     *
     * @since S60 v3.1
     */
    virtual ~CPhCntPbkThumbnailLoader();

// From base class CPhCntThumbnailLoaderBase
    
    /**
     * Starts the loading of thumbnail from contact, which is 
     * identified by contact id.
     *
     * @since S60 v3.1
     * @param aContactId Contact id, which identifies the contact where thumbnail
     * is loaded.
     */
     void DoLoadL( const CPhCntContactId& aContactId );
     
// From base class MPhCntThumbnailLoader
        
    /**
     * From MPhCntThumbnailLoader
     * 
     * @since S60 v3.1
     * @see MPhCntThumbnailLoader
     */
    void Release();
    
    /**
     * From MPhCntThumbnailLoader
     * 
     * @since S60 v3.1
     * @see MPhCntThumbnailLoader
     */
    void Cancel();
     
private:

    /**
     * From MPbkThumbnailGetObserver, called when 
     * thumbnail loading is completed.
     *
     * @param aOperation the completed operation.
     * @param aBitmap The loaded bitmap. Callee is responsible of 
     *                the bitmap.
     */
    void PbkThumbnailGetComplete(
        MPbkThumbnailOperation& aOperation, 
        CFbsBitmap* aBitmap );

    /**
     * From MPbkThumbnailGetObserver, called if 
     * the thumbnail loading fails.
     *
     * @param aOperation the failed operation.
     * @param aError error code of the failure.
     */
    void PbkThumbnailGetFailed(
        MPbkThumbnailOperation& aOperation, 
        TInt aError );
   
private:

    CPhCntPbkThumbnailLoader( 
        MPhoneCntPbkOwner& aOwner );

    void ConstructL();
    
    /**
     * Clears all pbk stuff.
     */
    void ClearPbk( TBool aMore = ETrue );

private: // data
    
    /**
     * Owner of contact access.
     * Not own.
     */
    MPhoneCntPbkOwner& iOwner;
   
    /**
     * Thumnail loading operation.
     * own.
     */
    MPbkThumbnailOperation* iPbkGetOp;
    
    /**
     * Contact.
     * Own.
     */
    CPbkContactItem* iPbkItem;
    
    /**
     * Thumbnail manager.
     * Own.
     */
    CPbkThumbnailManager* iPbkManager;
    };


#endif // CPHCNTPBKTHUMBNAILLOADER_H