|
|
Classification: |
C++ |
Category: |
Messaging |
Created: |
10/08/2004 |
Modified: |
10/14/2004 |
Number: |
FAQ-1151 |
Platform: |
Symbian OS v6.1, Symbian OS v7.0, Symbian OS v7.0s, Symbian OS v8.0 |
|
Question: How do I add an attachment to the message ?
Answer: The code snippet below allows you to create and insert a BT/IR message with attachment in the Inbox of the messaging app.
You can use this code in your application to help you for example to debug your recognizer for handling your MIME type (instead
of testing it on the device by beaming your file over BT or IR), notify a user of an event, deliver a message to the user
etc. The code has been compiled against Series60 1.2 and 2.1.
You will need these libraries...
msgs.lib // main messaging library efsrv.lib Estor.lib
Include the following header files...
#include #include OR #include
// Use these files if you are creating a BT message // #include // Series60 #include // UIQ
Step 1
In one of your classes in your code sub-class from MMsvSessionObserver (defined in mtclreg.h) for use when opening a session with the message server.
class CMyClass : public CBase, public MMsvSessionObserver { ...
/** * From MMsvSessionObserver. */ void HandleSessionEventL(TMsvSessionEvent aEvent, TAny* aArg1, TAny* aArg2, TAny* aArg3);
/** * Creates a message in the Inbox. */ void CreateInboxMessageL(); ... ... };
Step 2
Use these methods and invoke CreateInboxMessageL() at the appropriate point.
void ExternaliseAndCommit1FileNameL(CMsvEntry* aEntry, const TUid aMsgTypeUid, const TDesC16* aFileName) { CMsvStore* messageStore = aEntry->EditStoreL(); CleanupStack::PushL(messageStore);
RMsvWriteStream messageWriteStream; messageWriteStream.AssignL(*messageStore, aMsgTypeUid);
messageWriteStream.WriteInt32L(aFileName->Length()); messageWriteStream.WriteL(*aFileName);
messageWriteStream.CommitL(); messageWriteStream.Close();
messageStore->CommitL(); CleanupStack::PopAndDestroy(); //messageStore }
struct TEntryInfoHolder { CMsvSession* messageSession; TMsvId iEntryId; };
LOCAL_C void DeleteEntry(TAny* aObject) { TEntryInfoHolder* object = reinterpret_cast (aObject); object->messageSession->RemoveEntry(object->iEntryId); }
void CMyClass::CreateInboxMessageL() { CMsvSession* messageSession; CClientMtmRegistry* registry; TFileName details; TFileName description; TFileName fileName; TEntryInfoHolder infoHolder;
messageSession = CMsvSession::OpenSyncL(*this); CleanupStack::PushL(messageSession);
registry = CClientMtmRegistry::NewL(*messageSession); CleanupStack::PushL(registry);
infoHolder.messageSession=messageSession; infoHolder.iEntryId=0; // No entry yet ! CleanupStack::PushL(TCleanupItem(DeleteEntry, &infoHolder));
// Subject _LIT(KSub, "Test Hello"); details.Copy(KSub());
_LIT(KFile, "c:\\testSIS.sis"); _LIT(KFileName, "testSIS.sis"); description.Copy(KFileName());
CMsvEntry* inbox=messageSession->GetEntryL(KMsvGlobalInBoxIndexEntryIdValue); CleanupStack::PushL(inbox);
TMsvEntry newEntry;
// If using BT uncomment line // newEntry.iMtm = TUid::Uid(KUidMsgTypeBT); newEntry.iMtm = TUid::Uid(KUidMsgTypeIr);
newEntry.SetVisible(EFalse); newEntry.SetInPreparation(ETrue); newEntry.iType = KUidMsvMessageEntry; newEntry.iServiceId = KMsvUnknownServiceIndexEntryId; newEntry.iDate.HomeTime(); newEntry.iSize = 0;//todo newEntry.iDetails.Set(details); newEntry.iDescription.Set(description); inbox->CreateL(newEntry); infoHolder.iEntryId=newEntry.Id();
CClientMtmRegistry* mtmReg = CClientMtmRegistry::NewL(*messageSession); CleanupStack::PushL(mtmReg);
CMsvEntry* entry=messageSession->GetEntryL(newEntry.Id()); CleanupStack::PushL(entry); CBaseMtm *mtm = mtmReg->NewMtmL(entry->Entry().iMtm); mtm->SetCurrentEntryL(entry); // takes ownership CleanupStack::Pop(); // entry CleanupStack::PushL(mtm);
// Create an empty attachment TFileName tempfileName; TMsvId attachmentId; mtm->CreateAttachmentL(attachmentId, tempfileName);
// Construct the path of the file to be created as attachment HBufC* completeFilePath = HBufC::NewLC(500); TPtr completeFilePathPtr = completeFilePath->Des(); completeFilePathPtr.Append(tempfileName); completeFilePathPtr.Append(description);
RFs session; session.Connect(); CleanupClosePushL(session); CFileMan* fman = CFileMan::NewL(session); TInt err =fman->Copy(KFileName(),*completeFilePath);
delete fman; CleanupStack::PopAndDestroy(); // completeFilePath CleanupStack::PopAndDestroy(); // session
CMsvEntry* attachment=messageSession->GetEntryL(attachmentId); TMsvEntry attachmentEntry=attachment->Entry(); CleanupStack::PushL(attachment);
fileName.Append(description); TEntry fileEntry; messageSession->FileSession().Entry(fileName, fileEntry); attachmentEntry.iDetails.Set(description); attachmentEntry.iDate.HomeTime(); attachmentEntry.iSize = fileEntry.iSize;
// When using BT uncomment below // // ExternaliseAndCommit1FileNameL(attachment, TUid::Uid( KUidMsgTypeBT ), &description); // Note: IR does not require the
BT UID param. ExternaliseAndCommit1FileNameL(attachment, TUid::Uid( KUidMsgTypeIr) , &description); // Note: IR does not require the BT
UID param.
attachment->ChangeL(attachmentEntry); CleanupStack::PopAndDestroy(); // attachment
newEntry = entry->Entry(); newEntry.iSize = fileEntry.iSize; newEntry.SetVisible(ETrue); newEntry.SetInPreparation(EFalse); newEntry.SetUnread(ETrue); entry->ChangeL(newEntry);
CleanupStack::PopAndDestroy(3); // inbox, mtmReg and mtm CleanupStack::Pop(); // TCleanupItem(DeleteEntry, &infoHolder CleanupStack::PopAndDestroy(2); // messageSession, registry }
Caveats
1. Code might compile but not work depending on if BT or IR is supported for a given device. 2. On the Emulator the user is NOT notified after the message has been added in the Inbox. This means that the user has to
start the messaging app manually. 3. Refer to FAQ-1138 for limitations on creating user defined mailboxes.
|
|
|