S60 3rd Edition API Reference: cmessagedata.h Source File

00001 /*
00002 * ============================================================================
00003 *  Name        : CMessageData.h
00004 *  Part of     : Messaging / SendUI?Subsystem_name / ?Module_name       *** Info from the SWAD
00005 *  Description : Encapsulates the message data for sending services.
00006 *  Version     : %version: % << Don't touch! Updated by Synergy at check-out.
00007 *
00008 *  Copyright � 2002-2006 Nokia.  All rights reserved.
00009 *  This material, including documentation and any related computer
00010 *  programs, is protected by copyright controlled by Nokia.  All
00011 *  rights are reserved.  Copying, including reproducing, storing,
00012 *  adapting or translating, any or all of this material requires the
00013 *  prior written consent of Nokia.  This material also contains
00014 *  confidential information which may not be disclosed to others
00015 *  without the prior written consent of Nokia.
00016 * ============================================================================
00017 * Template version: 4.1
00018 */
00019 #ifndef C_MESSAGEDATA_H
00020 #define C_MESSAGEDATA_H
00021 
00022 #include <e32Base.h>
00023 #include <badesca.h>
00024 #include <f32file.h>
00025 #include <msvstd.h>
00026 #include "CMessageAddress.h"
00027 
00028 class MDesC16Array;
00029 class CRichText;
00030 
00041 class CMessageData : public CBase
00042 {
00043 public:  // Constructors and destructor
00044 
00050     IMPORT_C static CMessageData* NewL();
00051     
00057     IMPORT_C static CMessageData* NewLC();
00058 
00062     IMPORT_C virtual ~CMessageData();
00063 
00064 public: // New functions
00065 
00073     IMPORT_C void SetSubjectL( const TDesC* aSubject );
00074 
00081     IMPORT_C const TPtrC Subject() const;
00082 
00090     IMPORT_C void AppendAttachmentL( const TDesC& aFilePath );
00091 
00098     IMPORT_C const CDesCArray& AttachmentArray() const;
00099     
00106     IMPORT_C void ClearAttachmentArray();
00107 
00116     IMPORT_C void AppendToAddressL(
00117         const TDesC& aAddress,
00118         const TDesC& aAlias = KNullDesC);
00119 
00126     IMPORT_C const CMessageAddressArray& ToAddressArray() const;
00127 
00137     IMPORT_C void AppendCcAddressL(
00138         const TDesC& aCcAddress,
00139         const TDesC& aCcAlias = KNullDesC);
00140 
00147     IMPORT_C const CMessageAddressArray& CcAddressArray() const;
00148 
00158     IMPORT_C void AppendBccAddressL(
00159         const TDesC& aBccAddress,
00160         const TDesC& aBccAlias = KNullDesC);
00161 
00168     IMPORT_C const CMessageAddressArray& BccAddressArray() const;
00169 
00177     IMPORT_C void SetBodyTextL( const CRichText* aBodyText );
00178 
00185     IMPORT_C const CRichText* BodyText() const;
00186     
00198     IMPORT_C void AppendAttachmentHandleL( const RFile& aFileHandle );
00199 
00206     IMPORT_C const RArray<RFile>& AttachmentHandleArray() const;
00207 
00215     IMPORT_C TUid DataType() const;
00216 
00223     IMPORT_C void ClearAddresses();
00224 
00225     
00226     
00227 
00228  protected:
00229 
00233     IMPORT_C CMessageData();
00234 
00238     IMPORT_C void ConstructL();
00239 
00240 
00241 
00242 
00243 protected:  // Data
00247     TUid                            iDataType;
00248 
00249 private:  // Data
00250 
00255     HBufC*                          iSubject;
00256 
00261     CRichText*                      iBodyText;
00262 
00267      CDesCArray*                     iAttachments;
00268     
00273     CMessageAddressArray*           iToAddresses;
00274     
00279     CMessageAddressArray*           iCcAddresses;
00280     
00285     CMessageAddressArray*           iBccAddresses;
00286 
00291     RArray<RFile>                   iAttachmentHandles;
00292 };
00293 
00294 // C_MESSAGEDATA_H
00295 #endif
00296 
00297 // End of File
00298