|
1 /* |
|
2 * Copyright (c) 2010 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 * Email message related operations |
|
16 */ |
|
17 |
|
18 #include "nmapiheaders.h" |
|
19 |
|
20 |
|
21 /*! |
|
22 \class NmApiMessageManager |
|
23 \brief A class for performing various operations on messages. |
|
24 */ |
|
25 |
|
26 |
|
27 namespace EmailClientApi |
|
28 { |
|
29 |
|
30 NmApiMessageManager::NmApiMessageManager(quint64 mailboxId,QObject *parent) |
|
31 :QObject(parent) |
|
32 { |
|
33 d = new NmApiMessageManagerPrivate(mailboxId,this); |
|
34 connect(d, SIGNAL(messagesCopied(int)),this,SIGNAL(messagesCopied(int))); |
|
35 connect(d, SIGNAL(messagesCreated(int)),this,SIGNAL(messagesCreated(int))); |
|
36 connect(d, SIGNAL(messagesMoved(int)),this,SIGNAL(messagesMoved(int))); |
|
37 connect(d, SIGNAL(messagesDeleted(int)),this,SIGNAL(messagesDeleted(int))); |
|
38 } |
|
39 |
|
40 NmApiMessageManager::~NmApiMessageManager() |
|
41 { |
|
42 delete d; |
|
43 } |
|
44 |
|
45 |
|
46 // creates a new email message |
|
47 // signaled with draftMessageCreated(NmApiMessage *message,int result) |
|
48 // * ownership transferred |
|
49 bool NmApiMessageManager::createDraftMessage(const QVariant *initData) |
|
50 { |
|
51 NM_FUNCTION; |
|
52 Q_UNUSED(initData); |
|
53 return false; |
|
54 } |
|
55 |
|
56 // creates fw message |
|
57 // signaled with forwardMessageCreated(NmApiMessage *message,int result) |
|
58 // * ownership transferred |
|
59 bool NmApiMessageManager::createForwardMessage(const QVariant *initData) |
|
60 { |
|
61 NM_FUNCTION; |
|
62 Q_UNUSED(initData); |
|
63 return false; |
|
64 } |
|
65 |
|
66 // creates reply message |
|
67 // signaled with replyMessageCreated(NmApiMessage *message,int result) |
|
68 // * ownership transferred |
|
69 bool NmApiMessageManager::createReplyMessage(const QVariant *initData, |
|
70 bool replyAll) |
|
71 { |
|
72 NM_FUNCTION; |
|
73 Q_UNUSED(initData); |
|
74 Q_UNUSED(replyAll); |
|
75 return false; |
|
76 } |
|
77 |
|
78 /*! |
|
79 \fn moveMessages |
|
80 \param messageIds Id list of source messages. |
|
81 \param sourceFolderId Id of the source folder. |
|
82 \param targetFolderId Id of the target folder. |
|
83 \return true if operation was successfully started. |
|
84 |
|
85 Starts async move operation for given messages. |
|
86 Completion signalled with messagesMoved(int result). |
|
87 */ |
|
88 bool NmApiMessageManager::moveMessages(const QList<quint64> messageIds, |
|
89 quint64 sourceFolderId, |
|
90 quint64 targetFolderId) |
|
91 { |
|
92 return d->moveMessages(messageIds,sourceFolderId,targetFolderId); |
|
93 } |
|
94 |
|
95 /*! |
|
96 \fn copyMessages |
|
97 \param messageIds Id list of source messages. |
|
98 \param sourceFolder Id of the source folder. |
|
99 \param targetFolder Id of the target folder. |
|
100 \return true if operation was successfully started. |
|
101 |
|
102 Starts async copy operation for given messages. |
|
103 Completion signalled with messagesCopied(int result). |
|
104 */ |
|
105 bool NmApiMessageManager::copyMessages(const QList<quint64> messageIds, |
|
106 quint64 sourceFolder, |
|
107 quint64 targetFolder) |
|
108 { |
|
109 return d->copyMessages(messageIds, sourceFolder, targetFolder); |
|
110 } |
|
111 |
|
112 // signaled with messageSaved(quint64 messageId, int result) |
|
113 bool NmApiMessageManager::saveMessage(const NmApiMessage &message) |
|
114 { |
|
115 Q_UNUSED(message); |
|
116 return false; |
|
117 } |
|
118 |
|
119 // deletes message |
|
120 // signaled with messagesDeleted(int result) |
|
121 bool NmApiMessageManager::deleteMessages(const QList<quint64> messageIds) |
|
122 { |
|
123 Q_UNUSED(messageIds); |
|
124 return false; |
|
125 } |
|
126 |
|
127 // starts fetching rest of message body from server |
|
128 // signaled with messageFetched(quint64 messageId, int result) |
|
129 bool NmApiMessageManager::fetch(const NmApiMessage &message) |
|
130 { |
|
131 Q_UNUSED(message); |
|
132 return false; |
|
133 } |
|
134 |
|
135 // moves message to outbox. Actual sending time may be immediate or scheduled |
|
136 // signaled with messageSent(quint64 messageId, int result) |
|
137 bool NmApiMessageManager::send(const NmApiMessage &message) |
|
138 { |
|
139 Q_UNUSED(message); |
|
140 return false; |
|
141 } |
|
142 |
|
143 // creates new attachment for a message. Currently attachment can be specified as file name (attachmentSpec is QString) |
|
144 // signaled with attachmentCreated(quint64 attachemntId) |
|
145 // * |
|
146 bool NmApiMessageManager::createAttachment(NmApiEmailMessage &message, |
|
147 const QVariant &attachmenSpec) |
|
148 { |
|
149 Q_UNUSED(message); |
|
150 Q_UNUSED(attachmenSpec); |
|
151 return false; |
|
152 } |
|
153 |
|
154 // removes attachment from a message |
|
155 // signaled with attachmentRemoved(int result) |
|
156 bool NmApiMessageManager::removeAttachment(NmApiEmailMessage &message, |
|
157 quint64 /*attachmentId*/) |
|
158 { |
|
159 Q_UNUSED(message); |
|
160 return false; |
|
161 } |
|
162 |
|
163 } // namespace EmailClientApi |
|
164 |
|
165 |