mobilemessaging/smsmtm/clientmtm/inc/SMSCLNT.H
changeset 0 72b543305e3a
child 9 1d7827e39b52
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mobilemessaging/smsmtm/clientmtm/inc/SMSCLNT.H	Thu Dec 17 08:44:11 2009 +0200
@@ -0,0 +1,150 @@
+// Copyright (c) 1999-2009 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".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// SMSCLNT.H
+//
+/**
+ * @file 
+ * @publishedAll
+ * @released
+ */
+#ifndef __SMSCLNT_H__
+#define __SMSCLNT_H__
+
+#include <mtclbase.h>
+#include <smuthdr.h>
+
+class CSmsHeader;
+class CSmsMessage;
+class CSmsSettings;
+class TSmsUtilities;
+class CSmsSimParamOperation;
+class CMobilePhoneSmspList;
+class RResourceFile;
+
+/** 
+The SMS client MTM interface.
+
+Most of the functions in this class are implementations of the virtual functions 
+defined by the base class CBaseMtm.
+
+An object of this class can be obtained from the Client MTM registry. The message
+server provides the necessary information required by the registry to provide
+the SMS client MTM.
+
+All client MTM objects have a current context. This is an entry in the message 
+store that will be manipulated by certain APIs supplied by the MTM. If the 
+current context is not set then certain APIs will panic. 
+
+The CBaseMtm::HasContext API can be used to check that the current context has 
+been set. It can be set using either the CBaseMtm::SwitchCurrenEntryL API or the
+CBaseMtm::SetCurrentEntryL API.
+
+@see	CClientMtmRegistry
+@see	CBaseMtm::HasContext
+@see	CBaseMtm::SetCurrentEntryL
+@see	CBaseMtm::SwitchCurrenEntryL
+
+@publishedAll
+@released
+*/
+NONSHARABLE_CLASS (CSmsClientMtm) : public CBaseMtm
+	{
+public:
+
+	IMPORT_C static CSmsClientMtm* NewL(CRegisteredMtmDll& aRegisteredMtmDll,CMsvSession& aSession);
+	virtual ~CSmsClientMtm();
+
+	void HandleEntryEvent(enum MMsvEntryObserver::TMsvEntryEvent,TAny*,TAny*,TAny*);
+
+	inline CSmsHeader& SmsHeader();
+	inline const CSmsHeader& SmsHeader() const;
+	inline CSmsSettings& ServiceSettings();
+	inline const CSmsSettings& ServiceSettings() const;
+	inline TInt ServiceId() const;
+
+	IMPORT_C void RestoreServiceAndSettingsL();
+	IMPORT_C CSmsSimParamOperation* ReadSimParamsL(TRequestStatus& aObserverRequestStatus);
+	IMPORT_C CSmsSimParamOperation* WriteSimParamsL(const CMobilePhoneSmspList& aList, TRequestStatus& aObserverRequestStatus);
+	IMPORT_C void SaveMessageL(CMsvStore& aEditStore, TMsvEntry& aEntry);
+	
+	/** 
+	Sets the character encoding value. The character encoding value options are 7-bit,
+	8-bit and 16-Bit Unicode. By default the character set encoding is 7 bit encoding.
+	*/
+	void SetMessageCharacterSetL(TSmsDataCodingScheme::TSmsAlphabet aTsmsAlphabet);
+
+public:	// methods from CBaseMtm
+
+	virtual void SaveMessageL(); 
+	virtual void LoadMessageL();
+	virtual TMsvPartList ValidateMessage(TMsvPartList aPartList);
+	virtual TMsvPartList Find(const TDesC& aTextToFind, TMsvPartList aPartList);
+	virtual CMsvOperation* ReplyL(TMsvId aDestination, TMsvPartList aPartList, TRequestStatus& aCompletionStatus);
+	virtual CMsvOperation* ForwardL(TMsvId aDestination, TMsvPartList aPartList, TRequestStatus& aCompletionStatus);
+	virtual void AddAddresseeL(const TDesC& aRealAddress);
+	virtual void AddAddresseeL(const TDesC& aRealAddress, const TDesC& aAlias);
+	virtual void RemoveAddressee(TInt aIndex);
+	virtual TInt QueryCapability(TUid aCapability, TInt& aResponse);
+	virtual void InvokeSyncFunctionL(TInt aFunctionId,const CMsvEntrySelection& aSelection, TDes8& aParameter);
+	virtual CMsvOperation* InvokeAsyncFunctionL(TInt aFunctionId,const CMsvEntrySelection& aSelection, TDes8& aParameter, TRequestStatus& aCompletionStatus);
+
+	IMPORT_C void CreateMessageL(TMsvId aServiceId);
+	IMPORT_C void BioTypeChangedL(TUid aBioTypeUid);
+	
+protected: 
+	/**
+	Methods from CBaseMtm, The implementation of this function assumes that
+    the new service for setting the charset encoding value for a SMS message is supported.
+    */
+	IMPORT_C virtual TInt Extension_(TUint aExtensionId, TAny*& a0, TAny* a1);
+ 
+private:
+
+	CSmsClientMtm(CRegisteredMtmDll& aRegisteredMtmDll,CMsvSession& aSession);
+	void ConstructL();
+
+	void BasicReplyForwardEntry(TMsvEntry& aNewEntry) const;
+	CMsvOperation* CreateNewEntryL(TMsvEntry& aNewEntry, TMsvId aDestination,CSmsHeader& aSmsHeader,const CRichText& aBody, TRequestStatus& aCompletionStatus);
+	TBool ValidRecipients() const;
+	TBool ValidNumber(const TDesC& aNumber) const;
+
+private:	// methods from CBaseMtm
+
+	virtual void ContextEntrySwitched(); 
+
+private:
+
+	void DoAddAddresseeL(const TDesC& aRealAddress, const TDesC& aAlias);
+	void AddRecipientL(const TDesC& aRealAddress, const TDesC& aAlias);
+	void DoAddRecipientL(CSmsHeader* aSmsHeader, const TDesC& aRealAddress, const TDesC& aAlias);
+	void ResetHeader();
+	TMsvPartList DoFindL(const TDesC& aTextToFind,TMsvPartList aPartList);
+	void FindL(const TDesC& aTextToFind, const TMsvPartList aPartList,TMsvPartList& aFoundList);
+	void FindInBodyL(const TDesC& aTextToFind, const TMsvPartList& aFoundList, TMsvPartList& aResult);
+	HBufC* ReadEmailSubjectFormatL(RResourceFile& aResourceFile, TInt aResourceId, const TDesC& aDefaultFormat);
+
+private:
+
+	CSmsSettings*	iServiceSettings;
+	TMsvId			iServiceId;
+	CSmsHeader*		iSmsHeader;
+	TChar			iRealAddressOpen;
+	TChar			iRealAddressClose;
+	HBufC*			iEmailForwardSubjectFormat;
+	HBufC*			iEmailReplySubjectFormat;
+	};
+
+#include <smsclnt.inl>
+
+#endif	// __SMSCLNT_H__