FCL/sf/app/commonemail: comparison emailservices/emailframework/inc/CFSMailClient.h

equal deleted inserted replaced

-:578830873419
+:ecc8def7944a
 /*
 * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies).
 * All rights reserved.
 * This component and the accompanying materials are made available
 * under the terms of "Eclipse Public License v1.0"
 * which accompanies this distribution, and is available
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
 #include <e32std.h>
 #include <e32base.h>
 #include "CFSMailClient.hrh"
+#include "cemailextensionbase.h"
 //<cmail>
 #include "MFSMailBrandManager.h"
 #include "CFSMailPlugin.h"
 //</cmail>
 class CFSFWImplementation;
 class CFSMailPluginManager;
-	/**
+/**
-	* @mainpage Freestyle Email API
+* @mainpage Freestyle Email API
-	*
+*
-	* @section sec1 Introduction
+* @section sec1 Introduction
-	*
+*
-	*    This is the mail API and framework used by the Freestyle email
+*    This is the mail API and framework used by the Freestyle email
-	*    client. It provides access to the message store for reading email
+*    client. It provides access to the message store for reading email
-	*    and to the sync engine for starting and stopping synchronizations.
+*    and to the sync engine for starting and stopping synchronizations.
-	*
+*
-	* @section sec2 Typical Usage From UI
+* @section sec2 Typical Usage From UI
-	*
+*
-	*  	// Initialize the access to the mail framework
+*   // Initialize the access to the mail framework
-	*  	CFSMailClient* mail = CFSMailClient::NewL();
+*   CFSMailClient* mail = CFSMailClient::NewL();
-	*  	CleanupClosePushL(*mail);
+*   CleanupClosePushL(*mail);
 *
-	*  	// List mailboxes for user to select which one to open
+*   // List mailboxes for user to select which one to open
-	*	RPointerArray<CFSMailBox> mailBoxes;
+*   RPointerArray<CFSMailBox> mailBoxes;
-	*	mailBoxes.Reset();
+*   mailBoxes.Reset();
-	*	TFSMailMsgId plugin; // null id if all mailboxes required
+*   TFSMailMsgId plugin; // null id if all mailboxes required
-	*	mail->ListMailBoxes(plugin,mailBoxes);
+*   mail->ListMailBoxes(plugin,mailBoxes);
 *   // Lets select the first one this time
-	*  	CFSMailBox * currentMailbox = mailboxes[0];
+*   CFSMailBox * currentMailbox = mailboxes[0];
 *
-	*   // list all mailbox folders for user
+*   // list all mailbox folders for user
-	*   RPointerArray<CFSMailFolder> folders = currentMailBox->ListFolders( );
+*   RPointerArray<CFSMailFolder> folders = currentMailBox->ListFolders( );
-	*
+*
-	*   // or get default folder, for example inbox
+*   // or get default folder, for example inbox
-	*	TFSMailMsgId folderId;
+*   TFSMailMsgId folderId;
-	*	folderId = mailBox->GetStandardFolderId( EFSInbox );
+*   folderId = mailBox->GetStandardFolderId( EFSInbox );
-	*  	CFSMailFolder* inbox = mail->GetFolderByUid(currentMailBox->GetId(),folderId);
+*   CFSMailFolder* inbox = mail->GetFolderByUid(currentMailBox->GetId(),folderId);
-	*
+*
-	*   // List messages in inbox
+*   // List messages in inbox
-	*   // select message details to be listed
+*   // select message details to be listed
-	*   TFSMailDetails details(EFSMsgDataStructure);
+*   TFSMailDetails details(EFSMsgDataStructure);
 *
-	*   // set sorting criteria
+*   // set sorting criteria
 *   TFSMailSortCriteria criteria;
 *   criteria.iField = EFSMailSortByDate;
 *   criteria.iOrder = EFSMailAscending;
 *   RArray<TFSMailSortCriteria> sorting;
 *   sorting.Append(criteria);
 *
 *   // get email list iterator from plugin
-	*   MFSMailIterator* iterator = folder->ListMessagesL(details,sorting);
+*   MFSMailIterator* iterator = folder->ListMessagesL(details,sorting);
 *
 *   //  list all messages from folder
 *   TFSMailMsgId currentMessageId; // first call contains NULL id as begin id
 *   RPointerArray<CFSMailMessage> messages;
 *   messages.Reset();
 *   iterator->NextL(currentMessageId, folder->GetMessageCount(), messages);
 *
-	*   // Show the first 5 messages to in the UI
+*   // Show the first 5 messages to in the UI
-	*   for(TInt i=0;i<messages.Count() && i<5;i++)
+*   for(TInt i=0;i<messages.Count() && i<5;i++)
-	*   {
+*   {
 *       MyHeaderShowMethod(messages[i]->GetSender().GetEmailAddress(),
 *                          messages[i]->GetSubject()
 *                          messages[i]->GetDate());
 *
 *       // get email body
-	*       CFSMailMessagePart* body = messages[i]->PlainTextBodyPartL();
+*       CFSMailMessagePart* body = messages[i]->PlainTextBodyPartL();
 *       if(body)
 *       {
 *           TBuf<n> text;
 *           TInt startOffset = 0;
 *           body->GetContentToBufferL(text,startOffset);
 *           MyPlainTextBodyShowMethod(text);
 *           delete body;
 *       }
 *
 *       //list email attachments
 *       RPointerArray<CFSMailMessagePart> attachments;
 *       attachments.Reset();
 *       {
 *           MyShowAttachmentNameMethod(attachments[i]->AttachmentName());
 *       }
 *       attachments.ResetAndDestroy();
 *   }
-	*
+*
 *   // clean iterator and tables
 *   messages.ResetAndDestroy();
 *   delete iterator;
 *   sorting.Reset();
 *   delete folder;
 *
-	*   // User should call close when terminating mail framework usage
+*   // User should call close when terminating mail framework usage
-	*   // when shutting down application close mail client singleton
+*   // when shutting down application close mail client singleton
-	*   CleanupStack::PopAndDestroy(mail);
+*   CleanupStack::PopAndDestroy(mail);
-	*
+*
-	* @section sec3 Observing Email Events.
+* @section sec3 Observing Email Events.
-	*
+*
-	*   // To be able to observe events an user has to
+*   // To be able to observe events an user has to
-	*   // implement MFSMailEventObserver interface.
+*   // implement MFSMailEventObserver interface.
-	*   // Here the COwnMailObserver class implements the interface.
+*   // Here the COwnMailObserver class implements the interface.
-	*   COwnMailObserver* ownObserver = COwnMailObserver::NewL();
+*   COwnMailObserver* ownObserver = COwnMailObserver::NewL();
-	*
+*
-	*   // Register to observe mail store events
+*   // Register to observe mail store events
-	*   mail->AddObserverL(*ownObserver);
+*   mail->AddObserverL(*ownObserver);
-	*
+*
-	*   // Now callbacks are done via the EventL function defined
+*   // Now callbacks are done via the EventL function defined
-	*   // in the MFSMailEventObserver and implemented in this case
+*   // in the MFSMailEventObserver and implemented in this case
-	*   // by the COwnMailObserver
+*   // by the COwnMailObserver
-	*
+*
-	*   // When user does not wish to observe events anymore
+*   // When user does not wish to observe events anymore
-	*   // he has to unregister
+*   // he has to unregister
-	*   mail->RemoveObserver( *ownObserver );
+*   mail->RemoveObserver( *ownObserver );
-	*
+*
-	*   // Remember that it must be done for each observer
+*   // Remember that it must be done for each observer
-	*   // in the end of the observation because the AddObserverL
+*   // in the end of the observation because the AddObserverL
-	*   // does not replace the observer
+*   // does not replace the observer
-	*
+*
-	* @section sec_groups Classes
+* @section sec_groups Classes
-	*
+*
-	* The following classes form the public API of the frame work.
+* The following classes form the public API of the frame work.
-	*
+*
-	* @section sec_info More Information
+* @section sec_info More Information
-	*
+*
-	* Copyright &copy; 2006 Nokia.  All rights reserved.
+* Copyright &copy; 2006 Nokia.  All rights reserved.
-	*
+*
-	* This material, including documentation and any related computer programs,
+* This material, including documentation and any related computer programs,
-	* is protected by copyright controlled by Nokia.  All rights are reserved.
+* is protected by copyright controlled by Nokia.  All rights are reserved.
-	* Copying, including reproducing, storing, adapting or translating, any or
+* Copying, including reproducing, storing, adapting or translating, any or
-	* all of this material requires the prior written consent of Nokia.  This
+* all of this material requires the prior written consent of Nokia.  This
-	* material also contains confidential information which may not be disclosed
+* material also contains confidential information which may not be disclosed
-	* to others without the prior written consent of Nokia.
+* to others without the prior written consent of Nokia.
-	*/
+*/
-NONSHARABLE_CLASS(CFSMailClient) : public CBase
+NONSHARABLE_CLASS(CFSMailClient) : public CExtendableEmail
 {
 public:
 /**
 * Creates a new CFSMailClient singleton instance or increments
 * reference count if singleton already exists
 *
 * @return CFSMailClient pointer
 */
 IMPORT_C static CFSMailClient* NewL( TInt aConfiguration );
 /**
 * Creates a new CFSMailClient singleton instance or increments
 * reference count if singleton already exists
 *
 * @return CFSMailClient pointer
 *
 * @param aMailBoxId mailbox id
 * @return mailbox object ( CFSMailBox ), ownership is transferred to user
 */
 IMPORT_C CFSMailBox* GetMailBoxByUidL( const TFSMailMsgId aMailBoxId);
 /**
 * returns email folder object related to given folder id
 *
 * @param aMailBoxId id of mailbox containing folder
 * @param aFolderId folder id
 * @param aMessageId message id
 * @param aDetails defines which details are included in email object
 *
 * @return email object (CFSMailMessage), ownership is transferred to user
 */
-	 IMPORT_C CFSMailMessage* GetMessageByUidL(const TFSMailMsgId aMailBoxId, const TFSMailMsgId aFolderId,
+IMPORT_C CFSMailMessage* GetMessageByUidL(const TFSMailMsgId aMailBoxId, const TFSMailMsgId aFolderId,
-	 										  const TFSMailMsgId aMessageId, const TFSMailDetails aDetails );
+const TFSMailMsgId aMessageId, const TFSMailDetails aDetails );
 /**
 * deletes emails defined in message id list
 *
 * @param aMailBoxId id of mailbox containing emails
 * @param aFolderId id of folder containing email
 * @param aMessageIds defines ids of email to be deleted
 */
 IMPORT_C void DeleteMessagesByUidL( const TFSMailMsgId aMailBoxId, const TFSMailMsgId aFolderId,
-	 									 const RArray<TFSMailMsgId>& aMessageIds );
+const RArray<TFSMailMsgId>& aMessageIds );
 /**
 * Deletes mail account. This asynchronous operation returns id that can
 * be later used for cancelling the operation.
 *
 * First item in array is primary sort criteria.
 *
 * @return email list iterator, ownership is transferred to user
 */
 IMPORT_C MFSMailIterator* ListMessages(
-						const TFSMailMsgId aMailBoxId,
+const TFSMailMsgId aMailBoxId,
-						const TFSMailMsgId  aFolderId,
+const TFSMailMsgId  aFolderId,
-						const TFSMailDetails  aDetails,
+const TFSMailDetails  aDetails,
-						const RArray<TFSMailSortCriteria>& aSorting);
+const RArray<TFSMailSortCriteria>& aSorting);
 /**
 * returns branding manager to handle branding elements
 *
 * @return branding manager (ownership in framework)
 */
 IMPORT_C TInt AuthenticateL(MFSMailRequestObserver& aOperationObserver);
 /**
 * get framework temp directory
-	 */
+*/
 IMPORT_C TDesC& GetTempDirL( );
 /**
 * clean framework temp directory
-	 */
+*/
 IMPORT_C void CleanTempDirL( );
 /**
 * cancels single pending asynchronous request
 *
 * @param aRequestId identifies request
-	 */
+*/
 IMPORT_C void CancelL( const TInt aRequestId );
 /**
 * cancels all pending asynchronous requests
-	 */
+*/
 IMPORT_C void CancelAllL( );
 /**
 * Calls plugin to change the name of the mailbox
 *
 * @param aMailboxId mailbox id
 * @param aMailboxName new name for the mailbox
 */
 IMPORT_C void SetMailboxName( const TFSMailMsgId aMailboxId, const TDesC& aMailboxName );
+//<qmail>
+/**
+* increments reference count to framework singleton
+	  * visibility change to public by Qmail
+*/
+IMPORT_C TInt IncReferenceCount();
+//</qmail>
+public: // from  CExtendableEmail
+/**
+* @see CExtendableEmail::ReleaseExtension
+*/
+IMPORT_C virtual void ReleaseExtension( CEmailExtension* aExtension );
+/**
+* Requests extension. Default implementation performs lookup only and
+* derived class should implement actual instantiation because it knows
+* extensions it supports
+* array but does not delete it.
+* @param aExtension extension to release
+*/
+IMPORT_C virtual CEmailExtension* ExtensionL( const TUid& aInterfaceUid );
 protected:
 private:
 /**
 ~CFSMailClient();
 /**
 * ConstructL
 */
-	 void ConstructL( TInt aConfiguration );
+void ConstructL( TInt aConfiguration );
 /**
 * returns framework singleton instance if exists
 */
-	 static CFSMailClient* Instance();
+static CFSMailClient* Instance();
-/**
-* increments reference count to framework singleton
-*/
-TInt IncReferenceCount();
 /**
 * decrements reference count to framework singleton
 */
 TInt DecReferenceCount();
 private: // data
-	/** framework singleton reference count */
+/** framework singleton reference count */
 TInt                     iReferenceCount;
-	/** */
+/** */
 CFSFWImplementation*     iFWImplementation;
-	/** branding manager pointer  */
+/** branding manager pointer  */
 MFSMailBrandManager*     iBrandManager;
 };
 #endif // __FSMAILCLIENT_H

changeset 20	ecc8def7944a
parent 18	578830873419
child 56	15bc1d5d6267