phonebookui/Phonebook/View/inc/CPbkThumbnailReaderBase.h
changeset 0 e686773b3f54
equal deleted inserted replaced
-1:000000000000 0:e686773b3f54
       
     1 /*
       
     2 * Copyright (c) 2002 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: 
       
    15 *     Class CPbkThumbnailManager implementation classes.
       
    16 *
       
    17 */
       
    18 
       
    19 
       
    20 #ifndef __CPbkThumbnailReaderBase_H__
       
    21 #define __CPbkThumbnailReaderBase_H__
       
    22 
       
    23 //  INCLUDES
       
    24 #include <e32base.h>
       
    25 #include "CPbkThumbnailManagerImpl.h"
       
    26 #include "MPbkImageReaderObserver.h"
       
    27 
       
    28 //  FORWARD DECLARATIONS
       
    29 class MPbkThumbnailGetObserver;
       
    30 class CPbkImageReader;
       
    31 class MPbkThumbnailGetImageObserver;
       
    32 class MPbkImageData;
       
    33 class CPbkImageDataWithInfo;
       
    34 class TPbkImageLoadParameters;
       
    35 
       
    36 
       
    37 // CLASS DECLARATION
       
    38 
       
    39 /**
       
    40  * Implementation base class for thumbnail readers.
       
    41  */
       
    42 NONSHARABLE_CLASS(CPbkThumbnailReaderBase) : 
       
    43         public CBase, 
       
    44         public MPbkThumbnailReader,
       
    45         private MPbkImageReaderObserver
       
    46     {
       
    47     protected: // interface
       
    48         /**
       
    49          * Constructor.
       
    50 		 * @param aObserver thumbnail get observer
       
    51          */
       
    52         CPbkThumbnailReaderBase(MPbkThumbnailGetObserver& aObserver);
       
    53 
       
    54         /**
       
    55          * Second phase constructor.
       
    56          */
       
    57         void ConstructL();
       
    58    
       
    59         /**
       
    60          * Destructor. Cancels any previously executing read operation and
       
    61          * destroys this object.
       
    62          */
       
    63         ~CPbkThumbnailReaderBase();
       
    64 
       
    65         /**
       
    66          * Returns the image reader.
       
    67          */
       
    68         CPbkImageReader& ImageReader()
       
    69 			{
       
    70 			return *iImageReader;
       
    71 			}
       
    72 
       
    73     public:  // from MPbkThumbnailReader
       
    74         void CancelRead();
       
    75 
       
    76     private:  // from MPbkImageReaderObserver
       
    77         void ImageReadComplete(CPbkImageReader& aReader, CFbsBitmap* aBitmap);
       
    78         void ImageReadFailed(CPbkImageReader& aReader, TInt aError);
       
    79 
       
    80     private: // data members
       
    81         /// Ref: observer
       
    82         MPbkThumbnailGetObserver& iObserver;
       
    83         /// Own: image reader
       
    84         CPbkImageReader* iImageReader;
       
    85     };
       
    86 
       
    87 
       
    88 /**
       
    89  * Implementation base class for thumbnail image readers.
       
    90  */
       
    91 NONSHARABLE_CLASS(CPbkThumbnailImageReaderBase) : 
       
    92         public CBase, 
       
    93         public MPbkThumbnailReader,
       
    94         private MPbkImageReaderObserver
       
    95     {
       
    96     protected: // Interface
       
    97         /**
       
    98          * Constructor.
       
    99          * @param aObserver observer to notify about progress of this 
       
   100          *        operation
       
   101          */
       
   102         CPbkThumbnailImageReaderBase
       
   103             (MPbkThumbnailGetImageObserver& aObserver);
       
   104 
       
   105         /**
       
   106          * Second phase constructor.
       
   107          */
       
   108         void ConstructL();
       
   109 
       
   110         /**
       
   111          * Destructor. Cancels any previously executing read operation and
       
   112          * destroys this object.
       
   113          */
       
   114         ~CPbkThumbnailImageReaderBase();
       
   115 
       
   116         /**
       
   117          * Returns the image reader.
       
   118          */
       
   119         CPbkImageReader& ImageReader()
       
   120 			{
       
   121 			return *iImageReader;
       
   122 			}
       
   123 
       
   124     private:  // Abstract interface for derived classes
       
   125         /**
       
   126          * Starts image reader.
       
   127          * 
       
   128          * @param aParameters  Optional parameters for resulting thumbnail
       
   129          */
       
   130         virtual void DoStartReadL
       
   131 			(const TPbkImageLoadParameters* aParameters = NULL) =0;
       
   132 
       
   133         /**
       
   134          * Creates and returns an image data object.
       
   135          */
       
   136         virtual MPbkImageData* CreateImageDataLC() =0;
       
   137 
       
   138     public:  // From MPbkThumbnailReader
       
   139         void StartReadL(const TPbkImageLoadParameters* aParameters = NULL);
       
   140         void CancelRead();
       
   141 
       
   142     private:  // From MPbkImageReaderObserver
       
   143         void ImageReadComplete
       
   144             (CPbkImageReader& aReader, CFbsBitmap* aBitmap);
       
   145         void ImageReadFailed(CPbkImageReader& aReader, TInt aError);
       
   146         void ImageOpenComplete(CPbkImageReader& aReader);
       
   147 
       
   148     private: // Implementation
       
   149         void HandleImageOpenCompleteL();
       
   150 
       
   151     private: // data members
       
   152         /// Ref: observer
       
   153         MPbkThumbnailGetImageObserver& iObserver;
       
   154         /// Own: image reader
       
   155         CPbkImageReader* iImageReader;
       
   156         /// Own: image data
       
   157         CPbkImageDataWithInfo* iImageData;
       
   158     };
       
   159 
       
   160 #endif // __CPbkThumbnailReaderBase_H__
       
   161 
       
   162 // End of File