calendarui/commonutils/inc/calenentryutil.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 02 Feb 2010 10:12:19 +0200
changeset 0 f979ecb2b13e
child 16 7bb9df301388
child 74 97232defd20e
permissions -rw-r--r--
Revision: 201003 Kit: 201005

/*
* Copyright (c) 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:   CalenEntryUtil stores data from edited Symbian CCalEntry
*                to format that match Calendar Editors fields. Editor fields
*                update CalenEntryUtil.
*
*/


#ifndef CALENEDITORDATA_H
#define CALENEDITORDATA_H

#include <e32base.h>

#include <caltime.h>
#include "calennotedatautil.h"
#include <calentry.h>


/**
 * CCalenEntryUtil contains edited data in exactly same format that editor 
 * fields show them. For example, alarm time is represented as alarm time,
 * not as offset to entry start time, like CalInterimApi represents it. 
 * 
 * This class or CCalenEditorDataHandler encapsulates rules how this data is 
 * then read from and write to CalInterimApi CCalEntry.
 *
 *  @lib CalenDefaultEditors
 *  @since S60 v3.0
 */
class CCalenEntryUtil : public CBase
    {
public:
    enum TTodoPriority
        {
        ETodoPriorityHigh = 1,
        ETodoPriorityNormal = 2,
        ETodoPriorityLow = 3
        };

    enum TSynchType
        {
        ESynchPrivate = 0,
        ESynchPublic, 
        ESynchNoSync
        };

public:
    IMPORT_C static CCalenEntryUtil* NewL( CCalEntry& aEntry, const TCalTime& aInstanceDateTime ); 

    virtual ~CCalenEntryUtil();

    // Getters
    IMPORT_C const TDesC& Summary() const;
    IMPORT_C const TDesC& Location() const;
    IMPORT_C const TDesC& Description() const;

    IMPORT_C const TTime& EventDateTime() const;
    IMPORT_C const TTime& StartDateTime() const;
    IMPORT_C const TTime& EndDateTime() const;

    IMPORT_C TBool IsAlarmActivated() const;
    IMPORT_C const TTime& AlarmDateTime() const;

	IMPORT_C TBool IsAllDayEvent();

    IMPORT_C TCalenRepeatIndex RepeatType() const;
    IMPORT_C const TTime& RepeatUntilDateTime() const;

    IMPORT_C TTodoPriority Priority() const;
    IMPORT_C TSynchType SynchType() const;
    IMPORT_C TInt AttachmentCount() const;
    IMPORT_C CCalAttachment* AttachmentL(TInt aIndex) const;

    // Setters
    IMPORT_C void SetSummaryL( const TDesC& aSummary );
    IMPORT_C void SetLocationL( const TDesC& aLocation );
    IMPORT_C void SetDescriptionL( const TDesC& aDescription );
    /** 
     * Set description by passing in new description in HBufC. 
     * CCalenEntryUtil takes ownership of new description. This can
     * be used to save unnecessary copying when setting description
     * created by Notepad API:
     */
    IMPORT_C void SetDescriptionTransferOwnershipL( HBufC* aDescription );

    IMPORT_C void SetStartDateTimeL( const TTime& aStart );
    IMPORT_C void SetEndDateTimeL( const TTime& aEnd );

    IMPORT_C void SetEventDateL( const TTime& aDate );

    IMPORT_C void SetAlarmOnL( const TTime& aTime );
    IMPORT_C void SetAlarmOffL();
    IMPORT_C void SetAlarmDateTimeL( const TTime& aTime );

    IMPORT_C void SetNonRepeatingL();
    IMPORT_C void SetRepeatingL(TCalenRepeatIndex aRepeatType, const TTime& aUntilDateTime );
    IMPORT_C void SetRepeatUntilDateTimeL(const TTime& aTime); 

    IMPORT_C void SetPriorityL(TTodoPriority aPriority);
    IMPORT_C void SetSynchTypeL(TSynchType aSynchType);
    IMPORT_C void SetEntryType( CCalEntry::TType aEntryType );
    IMPORT_C void SetAttachmentCount(TInt aAttachmentCount);
	/**
	 * @brief set AllDay field value
	 * @param aAllDayEvent
	 */
	IMPORT_C void SetAllDayEvent( TBool aAllDayEvent );

    // To get iEntryType
    IMPORT_C const CCalEntry::TType& EntryType() const;
    
    /*
    *To get iEntryStatus
    */
    IMPORT_C const CCalEntry::TStatus& Status() const;

    // Utility functions
    IMPORT_C TBool IsRepeating() const;
    
    /**
     * Return attachment names
     * 
     * @return HBufC 
     */
    IMPORT_C void AttachmentNamesL(RPointerArray<HBufC>& aAttachmentNames);
    
    /*
    * Allday event is an event  with a duration of n*24h.
    **/    
    IMPORT_C TBool CheckForAlldayEventL( TTime aStartTime, TTime aStopTime );
    
    /**
     * Return array of Rdates
     * 
     * @return RArray<TCalTime> 
     */
    IMPORT_C const RArray<TCalTime> GetRdatesL();
    
private:
    CCalenEntryUtil( CCalEntry& aEntry );

    void ConstructL(CCalEntry& aEntry, const TCalTime& aInstanceDateTime );

    void CopyDataFromEntryL( CCalEntry& aEntry, const TCalTime& aInstanceDateTime );
    TSynchType CCalenEntryUtil::GetSynchTypeL(const CCalEntry& aEntry);

private: // data

    /**
     * ?description_of_member
     */
    //?type ?member_name;

    /**
     * ?description_of_pointer_member
     * Own.  *** Write "Own" if this class owns the object pointed to; in
     other words, if this class is responsible for deleting it.
    */
    //?type* ?member_name;

    /**
     * ?description_of_pointer_member
     * Not own.  *** Write "Not own" if some other class owns this object.
     */
    //?type* ?member_name;

    /**
     * ?description_of_pointer_member
     * Own.
     */
    HBufC* iSummary;

    /**
     * ?description_of_pointer_member
     * Own.
     */
    HBufC* iLocation;

    /**
     * ?description_of_pointer_member
     * Own.
     */
    HBufC* iDescription;

    /**
     * ?description_of_member
     */
    TTime iStartDateTime;

    /**
     * ?description_of_member
     */
    TTime iEndDateTime;

    /**
     * ?description_of_member
     */
    TBool iIsAlarmActivated;

    /**
     * ?description_of_member
     */
	TBool iIsAllDayEvent;
    TTime iAlarmDateTime;

    /**
     * ?description_of_member
     */
    TCalenRepeatIndex iRepeatType;

    /**
     * ?description_of_member
     */
    TTime iRepeatUntilDateTime;

    /**
     * ?description_of_member
     */
    TTodoPriority iPriority;

    /**
     * ?description_of_member
     */
    TSynchType iSynchType;

    /**
     * Tells what type of entry does editor data referring to (i.e. Anniv, ToDo).
     * Set at construction. Used in DataHandler to force the correctness
     * of fields. (i.e. The rules to force the correctness of alarm fields
     * vary based on entry type)
     */    
    CCalEntry::TType iEntryType;
    
    /**
     * Tells the status values of the entry.
     */     
    CCalEntry::TStatus iEntryStatus;

    /**
     * The identifier for editing entry or instance
     */
    CalCommon::TRecurrenceRange iRecurrenceType;
    
    CCalEntry& iEntry;
    
    TInt iAttachmentCount;
    };

#endif // CALENEDITORDATA_H