diff -r 4e54af54a4a1 -r 6c59112cfd31 emailservices/nmclientapi/src/nmapimessagemanager.cpp --- a/emailservices/nmclientapi/src/nmapimessagemanager.cpp Wed Sep 15 17:47:19 2010 +0300 +++ b/emailservices/nmclientapi/src/nmapimessagemanager.cpp Thu Sep 30 11:43:07 2010 +0300 @@ -35,42 +35,43 @@ NmApiMessageManager::~NmApiMessageManager() { - delete d; } - - // creates a new email message - // signaled with draftMessageCreated(NmApiMessage *message,int result) - // * ownership transferred -bool NmApiMessageManager::createDraftMessage(const QVariant *initData) +/*! + \fn createDraftMessage + \param initData Initializing data. Can contain NULL value. + \return Create draft message operation. + + Creates a new email message. Returns create draft message operation. + */ +QPointer NmApiMessageManager::createDraftMessage(const QVariant *initData) { NM_FUNCTION; - Q_UNUSED(initData); - return false; + return d->createDraftMessage(initData); } // creates fw message // signaled with forwardMessageCreated(NmApiMessage *message,int result) // * ownership transferred - bool NmApiMessageManager::createForwardMessage(NmApiMessage *orig,const QVariant *initData) +QPointer NmApiMessageManager::createForwardMessage(NmApiMessage *orig,const QVariant *initData) { NM_FUNCTION; Q_UNUSED(initData); Q_UNUSED(orig); - return false; + return 0; } // creates reply message // signaled with replyMessageCreated(NmApiMessage *message,int result) // * ownership transferred -bool NmApiMessageManager::createReplyMessage(const NmApiMessage *orig, +QPointer NmApiMessageManager::createReplyMessage(const NmApiMessage *orig, const QVariant *initData,bool replyAll) { NM_FUNCTION; Q_UNUSED(orig); Q_UNUSED(initData); Q_UNUSED(replyAll); - return false; + return 0; } /*! @@ -83,7 +84,7 @@ Starts async move operation for given messages. Completion signalled with messagesMoved(int result). */ -bool NmApiMessageManager::moveMessages(const QList messageIds, +QPointer NmApiMessageManager::moveMessages(const QList messageIds, quint64 sourceFolderId, quint64 targetFolderId) { @@ -91,68 +92,82 @@ Q_UNUSED(messageIds); Q_UNUSED(sourceFolderId); Q_UNUSED(targetFolderId); - return false; + return 0; //return d->moveMessages(messageIds,sourceFolderId,targetFolderId); } -// signaled with messageSaved(quint64 messageId, int result) -bool NmApiMessageManager::saveMessage(const NmApiMessage &message) +/*! + \fn saveMessage + \param message Message to be saved (note that message must exists to complete successfully). + \return Save message operation. + + Saves email message. Message must be created before this operation with createDraftMessage/createForwardMessage/ + createReplyMessage operation. Operation will run unsuccessfully, if message haven't created before. + Returns save message operation. + */ +QPointer NmApiMessageManager::saveMessage(const NmApiMessage &message) { - Q_UNUSED(message); - return false; + return d->saveMessage(message); } // deletes message // signaled with messagesDeleted(int result) -bool NmApiMessageManager::deleteMessages(const QList messageIds) +QPointer NmApiMessageManager::deleteMessages(const QList messageIds) { Q_UNUSED(messageIds); - return false; + return 0; } // starts fetching rest of message body from server // signaled with messageFetched(quint64 messageId, int result) -bool NmApiMessageManager::fetchMessage(quint64 messageId) +QPointer NmApiMessageManager::fetchMessage(quint64 messageId) { Q_UNUSED(messageId); - return false; + return 0; } - // moves message to outbox. Actual sending time may be immediate or scheduled - // signaled with messageSent(quint64 messageId, int result) -bool NmApiMessageManager::sendMessage(const NmApiMessage &message) +/*! + \fn sendMessage + \param message Message to be sent (note that message must exists to complete successfully). + \return Send message operation. + + Sends email message. Message must be created before this operation with createDraftMessage/createForwardMessage/ + createReplyMessage operation. Operation will run unsuccessfully, if message haven't created before. + Returns send message operation. + */ +QPointer NmApiMessageManager::sendMessage(const NmApiMessage &message) { - Q_UNUSED(message); - return false; + NM_FUNCTION; + return d->sendMessage(message); } // creates new attachment for a message. Currently attachment can be specified as file name (attachmentSpec is QString) // signaled with attachmentCreated(quint64 attachemntId) // * -bool NmApiMessageManager::createAttachment(NmApiMessage &message, +QPointer NmApiMessageManager::createAttachment(NmApiMessage &message, const QVariant &attachmenSpec) { Q_UNUSED(message); Q_UNUSED(attachmenSpec); - return false; + return 0; } // removes attachment from a message // signaled with attachmentRemoved(int result) -bool NmApiMessageManager::removeAttachment(NmApiMessage &message, +QPointer NmApiMessageManager::removeAttachment(NmApiMessage &message, quint64 attachmentId) { Q_UNUSED(message); Q_UNUSED(attachmentId); - return false; + return 0; } -bool NmApiMessageManager::fetchAttachment(const NmApiMessage &relatedMessage, +QPointer NmApiMessageManager::fetchAttachment(const NmApiMessage &relatedMessage, quint64 attachmentId) { Q_UNUSED(relatedMessage); Q_UNUSED(attachmentId); - return false; + return 0; } } // namespace EmailClientApi