diff -r 000000000000 -r e686773b3f54 phonebookui/Phonebook/View/inc/CPbkThumbnailManagerImpl.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phonebookui/Phonebook/View/inc/CPbkThumbnailManagerImpl.h Tue Feb 02 10:12:17 2010 +0200 @@ -0,0 +1,171 @@ +/* +* 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: +* Class CPbkThumbnailManager implementation classes. +* +*/ + + +#ifndef __CPbkThumbnailManagerImpl_H__ +#define __CPbkThumbnailManagerImpl_H__ + +// INCLUDES +#include +#include // TStorageType +#include // EPbkFieldIdThumbnailImage +#include "CPbkThumbnailManager.h" +#include "CPbkImageManager.h" + +// CONSTANTS +// Size of thumbnail images stored to contacts +#define KPbkPersonalImageSize TSize(80,96) + +// FORWARD DECLARATIONS +class MPbkThumbnailGetObserver; +class MPbkThumbnailSetObserver; +class CPbkContactItem; +class CPbkFieldsInfo; +class TPbkImageLoadParameters; + + +// CLASS DECLARATION +/** + * Abstract thumbnail reader interface. + */ +NONSHARABLE_CLASS(MPbkThumbnailReader) : + public MPbkThumbnailOperation, public MPbkImageOperation + { + public: // Interface + /** + * Starts reading a thumbnail from the contact specified at creation + * time. + * @param aParameters Optional parameters for the thumbnail. + * + * @see TPbkImageLoadParameters + */ + virtual void StartReadL + (const TPbkImageLoadParameters* aParameters = NULL) =0; + + /** + * Cancels reading operation. + */ + virtual void CancelRead() =0; + }; + + +/** + * Abstract thumbnail image writer interface. + */ +NONSHARABLE_CLASS(MPbkThumbnailWriter) : + public MPbkThumbnailOperation, public MPbkImageOperation + { + public: // Interface + /** + * Starts writing a bitmap to the contact. + * + * @param aBitmap bitmap to save to contact. + */ + virtual void StartWriteL(const CFbsBitmap& aBitmap) =0; + + /** + * Starts writing an image buffer to the contact. + * + * @param aBuffer image buffer to save to contact. + */ + virtual void StartWriteL(const TDesC8& aBuffer) =0; + + /** + * Starts writing a file image to the contact. + * + * @param aFileName file image to save to contact. + */ + virtual void StartWriteL(const TDesC& aFileName) = 0; + + /** + * Cancels writing operation. + */ + virtual void CancelWrite() =0; + }; + + +/** + * Factory class for creating concrete MPbkThumbnailReader and + * MPbkThumbnailWriter instances. + */ +NONSHARABLE_CLASS(PbkThumbnailOperationFactory) + { + public: + /** + * Creates a concrete thumbnail reader object based on the type of + * the thumbnail field in the contact. + * + * @param aContact contact to get thumbnail from. + * @param aObserver observer to notify about progress of the operation. + * @param aFieldId Phonebook field type id of fetched image. + * Default field type id is EPbkFieldIdThumbnailImage. + * @return thumbnail reader object or NULL if aContact contains no + * thumbnail. + */ + static MPbkThumbnailReader* CreateReaderLC + (const CPbkContactItem& aContact, + MPbkThumbnailGetObserver& aObserver, + TInt aFieldId = EPbkFieldIdThumbnailImage); + + /** + * Creates a concrete thumbnail image reader object based on the type + * of the thumbnail field in the contact. + * + * @param aContact contact to get thumbnail from. + * @param aObserver observer to notify about progress of the operation. + * @param aFieldId Phonebook field type id of fetched image. + * Default field type id is EPbkFieldIdThumbnailImage. + * @return thumbnail reader object or NULL if aContact contains no + * thumbnail. + */ + static MPbkThumbnailReader* CreateImageReaderLC + (const CPbkContactItem& aContact, + MPbkThumbnailGetImageObserver& aObserver, + TInt aFieldId = EPbkFieldIdThumbnailImage); + + /** + * Creates a concrete writer object based on the type of the thumbnail + * field in the contact or in global field typing. + * + * @param aContact contact to write thumbnail to. + * @param aFieldsInfo global Phonebook field types. + * @param aObserver observer to notify about progress of the + * operation. + * @param aFieldId Phonebook field type id of fetched image. + * Default field type id is EPbkFieldIdThumbnailImage. + * @return thumbnail writer object. + */ + static MPbkThumbnailWriter* CreateWriterLC + (CPbkContactItem& aContact, + const CPbkFieldsInfo& aFieldsInfo, + MPbkThumbnailSetObserver& aObserver, + TInt aFieldId = EPbkFieldIdThumbnailImage); + + /** + * Returns true if aStorageType is supported for thumbnail field. + */ + static TBool SupportedStorageType(TStorageType aStorageType); + + private: + /// Namespace class, constructor not implemented. + PbkThumbnailOperationFactory(); + }; + +#endif // __CPbkThumbnailManagerImpl_H__ + +// End of File