diff -r 000000000000 -r 094583676ce7 wvuing/wvuieng/EngSrc/camessageutil.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/wvuing/wvuieng/EngSrc/camessageutil.h Thu Dec 17 08:41:52 2009 +0200 @@ -0,0 +1,91 @@ +/* +* Copyright (c) 2006-2006 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: General methods for message handling +* +*/ + + +#ifndef CAMESSAGEUTIL_H +#define CAMESSAGEUTIL_H + +// FORWARD DECLARATIONS +class TTime; +class MCAMessage; +class MCAMessageCreator; +class MCAMessagesWriteInterface; +class MCASettings; + +/** + * General message handling methods. + * + * General message handling methods which are to be used in both + * messagehandler and chatgroupmanager, to avoid duplicate code. + * + * @lib CAEngine.dll + * @since S60 v3.1 + */ +class CAMessageUtil // CSI: 51 # This is not a C-class although it begins with CA + { + public: + + /** + * Appends a datestamp to writeinterface if needed. + * New time is compared to the previous message in the interface. + * If the time values are from different date then datestamp is created + * Otherwise this does nothing. + * + * @since S60 v3.1 + * @param aNewTime Time of the new message + * @param aWriteInterface Interface to write the date message + * @param aMessageCreator for creating the date message + * @param aSettingsAPI Settings interface to determine if datestamps + * are required. + */ + static void AppendDateStampL( TTime aNewTime, + MCAMessagesWriteInterface& aWriteInterface, + MCAMessageCreator& aMessageCreator ); + + + /** + * Appends a datestamp and message to interface. Datestamp is added only + * if the date has changed between previous and current message. + * Ownership of the message is transferred or shared, so it doesn't + * need to be in cleanupstack. + * + * @since S60 v3.1 + * @param aNewMessage New message + * @param aWriteInterface Interface to write the date message + * @param aMessageCreator for creating the date message + * @param aSettingsAPI Settings interface to determine if datestamps + * are required. + * @param aSharedOwnership EFalse - ownership is transferred + * ETrue - ownership is shared + */ + static void AppendMessageWithDateStampL( + MCAMessage& aNewMessage, + MCAMessagesWriteInterface& aWriteInterface, + MCAMessageCreator& aMessageCreator, + TBool aSharedOwnership = EFalse ); + + private: + + /** + * C++ constructor & destructor + */ + CAMessageUtil(); + ~CAMessageUtil(); + }; + + +#endif // CAMESSAGEUTIL_H