1 /*

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

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

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

     6 * which accompanies this distribution, and is available

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

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Interface for loading thumbnails from contacts.

    15 *

    16 */

    17 

    18 

    19 #ifndef MPHCNTTHUMBNAILLOADER_H

    20 #define MPHCNTTHUMBNAILLOADER_H

    21 

    22 class CPhCntContactId;

    23 class MPhCntThumbnailLoaderObserver;

    24 class CFbsBitmap;

    25 

    26 /**

    27  * Observer interface for observing thumbnail loading

    28  * of MPhCntThumbnailLoader.

    29  * 

    30  * @lib PhoneCntFinder.

    31  * @since S60 v3.1

    32  */

    33 NONSHARABLE_CLASS( MPhCntLoaderObserver )

    34     {

    35 public:

    36 

    37     /**

    38      * Indication that loading has been made.

    39      * 

    40      * @since S60 v3.0

    41      * @param Pointer of bitmap loaded, ownership is given to caller.

    42      * May be null if error occured during loading.

    43      * @param aError Error code of loading.

    44      */

    45     virtual void LoadingCompleted( CFbsBitmap* aBitmap, TInt aError ) = 0;

    46     };

    47  

    48  

    49 /**

    50  *  Interface for thumbnail loader.

    51  *

    52  *  @lib PhoneCntFinder

    53  *  @since S60 v3.1

    54  */

    55 NONSHARABLE_CLASS( MPhCntThumbnailLoader )

    56     {

    57 

    58 public:

    59     

    60     /**

    61      * Destructor.

    62      *

    63      * @since S60 v3.1

    64      */

    65     virtual ~MPhCntThumbnailLoader() {};

    66     

    67      /**

    68       * Starts the loading of thumbnail from contact, which is 

    69       * identified by contact id.

    70       *

    71       * @since S60 v3.1

    72       * @param aContactId Contact id, which identifies the contact where thumbnail

    73       * is loaded.

    74       */

    75     virtual void LoadL( 

    76         const CPhCntContactId& aContactId,

    77         MPhCntLoaderObserver& aLoadingObserver ) = 0;

    78         

    79     /**

    80      * Indicats that loadings of thumbnails is done for now and 

    81      * resources can be released.

    82      *

    83      * @since S60 v3.1

    84      */

    85     virtual void Release() = 0;

    86     

    87     /**

    88      * Cancels the current loading.

    89      *

    90      * @since S60 v3.1

    91      */

    92     virtual void Cancel() = 0;

    93 

    94     };

    95 

    96 

    97 #endif // MPHCNTTHUMBNAILLOADER_H