diff -r b85b0c039c14 -r 1d94eb8df9c2 smf/smfservermodule/smfclient/client/smfgallery.h --- a/smf/smfservermodule/smfclient/client/smfgallery.h Fri May 21 15:40:57 2010 +0530 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,152 +0,0 @@ -/** - * Copyright (c) 2010 Sasken Communication Technologies Ltd. - * All rights reserved. - * This component and the accompanying materials are made available - * under the terms of the "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: - * Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution - * - * Contributors: - * Manasij Roy, Nalina Hariharan - * - * Description: - * The SmfGallery class - * - */ - -#ifndef SMFGALLERY_H -#define SMFGALLERY_H - -#include "smfglobal.h" -#include "smfprovider.h" -#include "smfclientglobal.h" -#include "smfpicture.h" -#include "smfcomment.h" - -#include -#include -#include - -#include - - - -class SmfGalleryPrivate; -/** - * @ingroup smf_client_group - * Interface to a remote gallery service. This class - * provides some basic gallery functionality to allow applications - * to interact with a picture gallery in a social network. - * - * Note that branding information for the particular service implementation - * is available from getProvider() API. See also: - * SmfProvider::serviceName(), SmfProvider::serviceIcon() - * - * All of the functionality described here should be implemented by a service - * specific plug-in object. - * Interface name for SmfGallery org.symbian.smf.client.gallery - */ -class SMFCLIENT_EXPORT SmfGallery : public QObject -{ - Q_OBJECT - -public: - /** - * Constructs SmfGallery. - * @param baseProvider The base provider info - * Seeing as this is a plug-in implementation, these will realistically - be generated by SMF factory of some kind - */ - - SmfGallery(SmfProvider* baseprovider); - ~SmfGallery(); - -public: - /** - * Get the picture listing asynchronously. - * The picturesAvailable() signal is emitted with SmfPictureList once the pictures have arrived. - * When the list is big user can specify the page number and per page item data. - * If not supplied by the user default values are used. - * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. - * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE - */ - void pictures(int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE); - - /** - * Returns a user title/caption for the picture - */ - QString description(SmfPicture& picture); - /** - * Gets the base provider info - */ - SmfProvider* getProvider() ; - //friend so that it can directly emit SmfPostProvider's signal - friend class SmfGalleryPrivate; -public slots: - /** - * Upload an image.Implemented as slot to connect to UI controls more easily - * uploadFinished() signal is emitted with the success value of the upload - * @param image the image to be uploaded - */ - void upload(SmfPicture* image) ; - - /** - * Upload an list image.Implemented as slot to connect to UI controls more easily - * uploadFinished() signal is emitted with the success value of the upload - * @param images the list image to be uploaded - */ - void upload(SmfPictureList* images) ; - - /** - * Posts a comment for an image. uploadFinished() signal is emitted - * with success of the post once comment is posted. - * @param image Image to comment on - * @param comment Comment to post - */ - void postComment(SmfPicture image, SmfComment comment) ; - /** - * Request for a custom operation. - * @param operationId OperationId - * @param customData Custom data to be sent - * Note:-Interpretation of operationId and customData is upto the concerned - * plugin and client application. service provider should provide some - * serializing-deserializing utilities for these custom data - */ - void customRequest(const int& operationId,QByteArray* customData){/*to be implemented*/}; -signals: - /* - * Notification on arrival of list of SmfPicture as a result of request. - * Note if number of friends is large, then it can download the list page by page. - * In that case this signal is emitted multiple times. - * through pictures(). - * @param pics Picture list - * @param error Error string - * @param resultPage Page number info - */ - void picturesAvailable(SmfPictureList* pics, SmfError error, SmfResultPage resultPage); - - /** - * Notification of the success of the uploading of image/comment - * @param error The upload success result of each individual pictures - */ - void uploadFinished(QList error); - /** - * Emitted when custom data is available - * @param operationId Requested operation id - * @param customData Custom data received, interpretation is not the responsibility of Smf - */ - void customDataAvailable(int operationId, QByteArray* customData); -private: - SmfProvider* m_baseProvider; - //private impl wrapper - SmfGalleryPrivate* m_private; - -}; - -SMF_SERVICE_NAME(SmfGallery, "org.symbian.smf.client.gallery\0.2") - -#endif // SMFGALLERY_H -