emailservices/emailclientapi/inc/emailmessage.h
author hgs
Mon, 23 Aug 2010 23:32:31 +0300
changeset 62 a8c646b56683
parent 47 f83bd4ae1fe3
permissions -rw-r--r--
201033
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
47
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). 
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description: mail message implementation definition
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef EMAILMESSAGE_H
hgs
parents:
diff changeset
    19
#define EMAILMESSAGE_H
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <memailmessage.h>
62
hgs
parents: 47
diff changeset
    22
#include "CFSMailCommon.h"
47
hgs
parents:
diff changeset
    23
#include "emailapiutils.h"
hgs
parents:
diff changeset
    24
#include "MFSMailRequestObserver.h"
hgs
parents:
diff changeset
    25
#include <QEventLoop>
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
using namespace EmailInterface;
hgs
parents:
diff changeset
    28
hgs
parents:
diff changeset
    29
class CFSMailMessagePart;
hgs
parents:
diff changeset
    30
class CFSMailMessage;
hgs
parents:
diff changeset
    31
class CFSMailAddress;
hgs
parents:
diff changeset
    32
class CFSMailPlugin;
hgs
parents:
diff changeset
    33
class CPluginData;
hgs
parents:
diff changeset
    34
class CEmailAddress;
hgs
parents:
diff changeset
    35
class CEmailAttachment;
hgs
parents:
diff changeset
    36
class CEmailTextContent;
hgs
parents:
diff changeset
    37
class CEmailMultipart;
hgs
parents:
diff changeset
    38
hgs
parents:
diff changeset
    39
NONSHARABLE_CLASS( CEmailMessage ) : public CBase, public MEmailMessage, public MFSMailRequestObserver
hgs
parents:
diff changeset
    40
    {
hgs
parents:
diff changeset
    41
public:
hgs
parents:
diff changeset
    42
    /**
hgs
parents:
diff changeset
    43
    * Creates email message from plugin message
hgs
parents:
diff changeset
    44
    */
hgs
parents:
diff changeset
    45
    static CEmailMessage* NewL( CPluginData& aPluginData,
hgs
parents:
diff changeset
    46
                                CFSMailMessage* aFsMessage,
hgs
parents:
diff changeset
    47
                                const TDataOwner aOwner );
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    ~CEmailMessage();
hgs
parents:
diff changeset
    50
hgs
parents:
diff changeset
    51
public: // from MEmailInterface
hgs
parents:
diff changeset
    52
    TEmailTypeId InterfaceId() const;
hgs
parents:
diff changeset
    53
    
hgs
parents:
diff changeset
    54
    void Release();
hgs
parents:
diff changeset
    55
    
hgs
parents:
diff changeset
    56
public: // from MEmailMessage
hgs
parents:
diff changeset
    57
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    58
    const TMessageId& MessageId() const;
hgs
parents:
diff changeset
    59
    
hgs
parents:
diff changeset
    60
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    61
    MEmailAddress* SenderAddressL() const;
hgs
parents:
diff changeset
    62
    
hgs
parents:
diff changeset
    63
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    64
    MEmailAddress* ReplyToAddressL() const;
hgs
parents:
diff changeset
    65
    
hgs
parents:
diff changeset
    66
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    67
    void SetReplyToAddressL( const MEmailAddress& aSender );
hgs
parents:
diff changeset
    68
    
hgs
parents:
diff changeset
    69
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    70
    TInt GetRecipientsL( const MEmailAddress::TRole aRole,
hgs
parents:
diff changeset
    71
        REmailAddressArray& aRecipients ) const;            
hgs
parents:
diff changeset
    72
    
hgs
parents:
diff changeset
    73
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    74
    void SetRecipientsL( const MEmailAddress::TRole aRole, REmailAddressArray& aRecipients );
hgs
parents:
diff changeset
    75
    
hgs
parents:
diff changeset
    76
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    77
    void RemoveRecipientL( const MEmailAddress& aRecipient );
hgs
parents:
diff changeset
    78
    
hgs
parents:
diff changeset
    79
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    80
    TPtrC Subject() const;
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    83
    void  SetSubjectL( const TPtrC& aSubject );    
hgs
parents:
diff changeset
    84
    
hgs
parents:
diff changeset
    85
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    86
    TTime Date() const;
hgs
parents:
diff changeset
    87
hgs
parents:
diff changeset
    88
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    89
    TInt Flags() const;
hgs
parents:
diff changeset
    90
    
hgs
parents:
diff changeset
    91
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    92
    void SetFlag( const TUint aFlag );
hgs
parents:
diff changeset
    93
    
hgs
parents:
diff changeset
    94
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    95
    void ResetFlag( const TUint aFlag );
hgs
parents:
diff changeset
    96
hgs
parents:
diff changeset
    97
    /**@see MEmailMessage */
hgs
parents:
diff changeset
    98
    MEmailMessageContent* ContentL() const;
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   101
    void SetContentL( const MEmailMessageContent* aContent );
hgs
parents:
diff changeset
   102
    
hgs
parents:
diff changeset
   103
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   104
    void SetPlainTextBodyL( const TDesC& aPlainText );
hgs
parents:
diff changeset
   105
hgs
parents:
diff changeset
   106
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   107
    MEmailAttachment* AddAttachmentL( const TDesC& aFullPath );
hgs
parents:
diff changeset
   108
    
hgs
parents:
diff changeset
   109
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   110
    MEmailAttachment* AddAttachmentL( RFile& aFile );
hgs
parents:
diff changeset
   111
    
hgs
parents:
diff changeset
   112
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   113
    TInt GetAttachmentsL( REmailAttachmentArray& aAttachments );
hgs
parents:
diff changeset
   114
    
hgs
parents:
diff changeset
   115
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   116
    void RemoveAttachmentL( const MEmailAttachment& aAttachment );
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   119
    const TFolderId& ParentFolderId() const;
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   122
    void SaveChangesL();
hgs
parents:
diff changeset
   123
hgs
parents:
diff changeset
   124
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   125
    void SendL();
hgs
parents:
diff changeset
   126
hgs
parents:
diff changeset
   127
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   128
    void ShowMessageViewerL();
hgs
parents:
diff changeset
   129
    
hgs
parents:
diff changeset
   130
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   131
    void ReplyToMessageL( const TBool aReplyToAll = ETrue );
hgs
parents:
diff changeset
   132
    
hgs
parents:
diff changeset
   133
    /**@see MEmailMessage */
hgs
parents:
diff changeset
   134
    void ForwardMessageL();
hgs
parents:
diff changeset
   135
    
hgs
parents:
diff changeset
   136
protected: // From MFSMailRequestObserver
hgs
parents:
diff changeset
   137
    void RequestResponseL( TFSProgress aEvent, TInt aRequestId );
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
private:        
hgs
parents:
diff changeset
   140
hgs
parents:
diff changeset
   141
    // Copies/moves flag values from iPluginMessage's flags to local flag member variable
hgs
parents:
diff changeset
   142
    void InitializeFlagValues();
hgs
parents:
diff changeset
   143
    
hgs
parents:
diff changeset
   144
    CEmailMessage( CPluginData& aPluginData, CFSMailMessage* aMessage, const TDataOwner aOwner );
hgs
parents:
diff changeset
   145
    
hgs
parents:
diff changeset
   146
    void ConstructL();
hgs
parents:
diff changeset
   147
							       
hgs
parents:
diff changeset
   148
    void ConvertAddressArrayL( const MEmailAddress::TRole aRole, 
hgs
parents:
diff changeset
   149
                               const RPointerArray<CFSMailAddress>& aSrc, 
hgs
parents:
diff changeset
   150
                               REmailAddressArray& aDst ) const; 
hgs
parents:
diff changeset
   151
    CEmailAddress* CreateAddressLC( const MEmailAddress::TRole aRole, CFSMailAddress& aFsAddress ) const;
hgs
parents:
diff changeset
   152
    TUint MapFlags( const TUint& aFlag );
hgs
parents:
diff changeset
   153
    
hgs
parents:
diff changeset
   154
    TMessageContentId MessageContentId( TEntryId aContentId ) const;
hgs
parents:
diff changeset
   155
        
hgs
parents:
diff changeset
   156
private:
hgs
parents:
diff changeset
   157
    CPluginData&    iPluginData;
hgs
parents:
diff changeset
   158
    
hgs
parents:
diff changeset
   159
    CFSMailPlugin*  iPlugin;
hgs
parents:
diff changeset
   160
hgs
parents:
diff changeset
   161
    TMessageId      iMessageId;
hgs
parents:
diff changeset
   162
    
hgs
parents:
diff changeset
   163
    TMessageContentId   iMsgContentId;
hgs
parents:
diff changeset
   164
                                                                                  
hgs
parents:
diff changeset
   165
    mutable CEmailAddress*  iSender;
hgs
parents:
diff changeset
   166
    
hgs
parents:
diff changeset
   167
    mutable CEmailAddress*  iReplyTo;
hgs
parents:
diff changeset
   168
    
hgs
parents:
diff changeset
   169
    REmailAddressArray iRecipients;
hgs
parents:
diff changeset
   170
    
hgs
parents:
diff changeset
   171
    CFSMailMessage* iPluginMessage;
hgs
parents:
diff changeset
   172
    
hgs
parents:
diff changeset
   173
    TUint        iFlags;
hgs
parents:
diff changeset
   174
    
hgs
parents:
diff changeset
   175
    mutable CEmailTextContent *iTextContent;
hgs
parents:
diff changeset
   176
    mutable CEmailMultipart* iContent;
hgs
parents:
diff changeset
   177
    RPointerArray<CEmailAttachment> iAttachments;
hgs
parents:
diff changeset
   178
    TDataOwner iOwner;
hgs
parents:
diff changeset
   179
    QEventLoop iEventLoop;
hgs
parents:
diff changeset
   180
    TInt iError;
hgs
parents:
diff changeset
   181
hgs
parents:
diff changeset
   182
    };
hgs
parents:
diff changeset
   183
//Class for compare email content type 
hgs
parents:
diff changeset
   184
class TContentType
hgs
parents:
diff changeset
   185
{
hgs
parents:
diff changeset
   186
public:
hgs
parents:
diff changeset
   187
    TContentType( const TDesC& aContentType );
hgs
parents:
diff changeset
   188
    // Returns ETrue iff the content type represented by this object 
hgs
parents:
diff changeset
   189
    // (after parameters have been removed) is equal to the given content type.
hgs
parents:
diff changeset
   190
    TBool Equals( const TDesC& aContentType );
hgs
parents:
diff changeset
   191
hgs
parents:
diff changeset
   192
private:
hgs
parents:
diff changeset
   193
    // Content type (without parameters)
hgs
parents:
diff changeset
   194
    TPtrC iContentType;
hgs
parents:
diff changeset
   195
};
hgs
parents:
diff changeset
   196
hgs
parents:
diff changeset
   197
hgs
parents:
diff changeset
   198
#endif // EMAILMESSAGE_H
hgs
parents:
diff changeset
   199
hgs
parents:
diff changeset
   200
// End of file