/*

* 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.

*

*/

//debug

#include "calendarui_debug.h"

#include "calenentryutil.h"

#include <calendateutils.h>

#include <calalarm.h>

#include <calentry.h>

#include <calrrule.h>

#include <calattachment.h>

// Utility functions 

// ======== LOCAL FUNCTIONS ======== 

// -----------------------------------------------------------------------------

// ThrowAwaySecondsAndMicroSecondsL

// Remove the seconds and micro seconds part from a TTime.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

static TTime ThrowAwaySecondsAndMicroSecondsL( const TTime& aTime )

    {

    TRACE_ENTRY_POINT;

    TDateTime dt = aTime.DateTime();

    dt.SetSecond(0);

    dt.SetMicroSecond(0);

    TTime result( dt );

    TRACE_EXIT_POINT;

    return result;

    }

// -----------------------------------------------------------------------------

// DurationL

// Returns the difference between the start and end time of an entry.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

static TTimeIntervalMinutes DurationL( const CCalEntry& aEntry )

    {

    TRACE_ENTRY_POINT;

    TTimeIntervalMinutes duration;

    TTime start = aEntry.StartTimeL().TimeLocalL();

    TTime end = aEntry.EndTimeL().TimeLocalL(); 

    end.MinutesFrom( start, duration );

    TRACE_EXIT_POINT;

    return duration;

    }

// -----------------------------------------------------------------------------

// StoreDescriptorL

// Gets reference to target HBufC& and attempts to copy data to it.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

static void StoreDescriptorL(const TDesC& aSrc, HBufC*& aTgt)

    {

    TRACE_ENTRY_POINT;

    // Simplistic implementation

    delete aTgt; // it's safe to delete null pointers

    aTgt = NULL;

    aTgt = aSrc.AllocL();

    // Complex and more efficient implementation

//     if ( aSrc.Length() <= aTgt->Des().MaxLength() )

//         {

//         aTgt->Des().Copy( aSrc );

//         }

//     else

//         {

//         delete aTgt;

//         aTgt = NULL;

//         aTgt = aSrc.AllocL();

//         }

    TRACE_EXIT_POINT;

    }

// ======== MEMBER FUNCTIONS ========

// -----------------------------------------------------------------------------

// CCalenEntryUtil::NewL

// Two-phased constructor.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C CCalenEntryUtil* CCalenEntryUtil::NewL(CCalEntry& aEntry, 

const TCalTime& aInstanceDateTime )

    {

    TRACE_ENTRY_POINT;

    CCalenEntryUtil* self = new (ELeave) CCalenEntryUtil(aEntry);

    CleanupStack::PushL( self );

    self->ConstructL(aEntry, aInstanceDateTime);

    CleanupStack::Pop( self );

    TRACE_EXIT_POINT;

    return self;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::~CCalenEntryUtil

// Destructor.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

CCalenEntryUtil::~CCalenEntryUtil()

    {

    TRACE_ENTRY_POINT;

    delete iSummary;

    delete iLocation;

    delete iDescription;

    TRACE_EXIT_POINT;

    }

// Getters

EXPORT_C const CCalEntry::TType& CCalenEntryUtil::EntryType() const

    {

     TRACE_ENTRY_POINT;

     TRACE_EXIT_POINT;

     return iEntryType;   

    }

EXPORT_C const CCalEntry::TStatus& CCalenEntryUtil::Status() const

	{

	TRACE_ENTRY_POINT; 

	TRACE_EXIT_POINT;

	return iEntryStatus; 

	}

// -----------------------------------------------------------------------------

// CCalenEntryUtil::Summary

// Returns the summary.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TDesC& CCalenEntryUtil::Summary() const

    {

    TRACE_ENTRY_POINT;

    ASSERT( iSummary );

    TRACE_EXIT_POINT;

    return *iSummary;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::Location

// Returns the location.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TDesC& CCalenEntryUtil::Location() const

    {

    TRACE_ENTRY_POINT;

    ASSERT( iLocation );

    TRACE_EXIT_POINT;

    return *iLocation;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::Description

// Returns the description.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TDesC& CCalenEntryUtil::Description() const

    {

    TRACE_ENTRY_POINT;

    ASSERT( iDescription );

    TRACE_EXIT_POINT;

    return *iDescription;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::StartDateTime

// Returns the start date time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TTime& CCalenEntryUtil::StartDateTime() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iStartDateTime;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::EndDateTime

// Returns the end date time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TTime& CCalenEntryUtil::EndDateTime() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iEndDateTime;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::EventDateTime

// Returns the event date time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TTime& CCalenEntryUtil::EventDateTime() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return StartDateTime();

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::IsAlarmActivated

// Returns ETrue if the alarm is activated, EFalse otherwise.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C TBool CCalenEntryUtil::IsAlarmActivated() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iIsAlarmActivated;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::IsAllDayEvent

// Returns ETrue if meeting is AllDay event, EFalse otherwise.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C TBool CCalenEntryUtil::IsAllDayEvent()

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iIsAllDayEvent;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::AlarmDateTime

// Returns the alarm date time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TTime& CCalenEntryUtil::AlarmDateTime() const

    {

    TRACE_ENTRY_POINT;

    ASSERT( iIsAlarmActivated );

    TRACE_EXIT_POINT;

    return iAlarmDateTime;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::RepeatType

// Returns the repeat type.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C TCalenRepeatIndex CCalenEntryUtil::RepeatType() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iRepeatType;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::RepeatUntilDateTime

// Returns the date/time until which this entry repeats.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C const TTime& CCalenEntryUtil::RepeatUntilDateTime() const

    {

    TRACE_ENTRY_POINT;

    ASSERT( IsRepeating() );

    TRACE_EXIT_POINT;

    return iRepeatUntilDateTime;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::Priority

// Returns the priority.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C CCalenEntryUtil::TTodoPriority CCalenEntryUtil::Priority() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iPriority;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SynchType

// Returns the synchronisation type.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C CCalenEntryUtil::TSynchType CCalenEntryUtil::SynchType() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iSynchType;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::AttachmentCount

// Returns the attachment's count

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C TInt CCalenEntryUtil::AttachmentCount() const

    {

    TRACE_ENTRY_POINT;

    TRACE_EXIT_POINT;

    return iAttachmentCount;

    }

// Setters

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetSummaryL

// Sets the summary.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetSummaryL( const TDesC& aSummary )

    {

    TRACE_ENTRY_POINT;

    StoreDescriptorL( aSummary, iSummary );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetLocationL

// Sets the location.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetLocationL( const TDesC& aLocation )

    {

    TRACE_ENTRY_POINT;

    StoreDescriptorL( aLocation, iLocation );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetDescriptionL

// Sets the description.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetDescriptionL( const TDesC& aDescription )

    {

    TRACE_ENTRY_POINT;

    StoreDescriptorL( aDescription, iDescription );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetDescriptionTransferOwnershipL

// Sets the description, passing ownership of aDescription.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetDescriptionTransferOwnershipL( HBufC* aDescription )

    {

    TRACE_ENTRY_POINT;

    delete iDescription;

    iDescription = aDescription;

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetStartDateTimeL

// Sets the start date/time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetStartDateTimeL( const TTime& aStart )

    {

    TRACE_ENTRY_POINT;

    iStartDateTime = ThrowAwaySecondsAndMicroSecondsL( aStart );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetEndDateTimeL

// Sets the end date/time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetEndDateTimeL( const TTime& aEnd )

    {

    TRACE_ENTRY_POINT;

    iEndDateTime = ThrowAwaySecondsAndMicroSecondsL( aEnd );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetEventDateL

// Sets the event date.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetEventDateL( const TTime& aDate)

    {

    TRACE_ENTRY_POINT;

    TTime midnight = CalenDateUtils::BeginningOfDay( aDate );

    SetStartDateTimeL( midnight );

    SetEndDateTimeL( midnight );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetAlarmOnL

// Sets the alarm to be active at the given date/time.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetAlarmOnL( const TTime& aAlarmTime )

    {

    TRACE_ENTRY_POINT;

    iIsAlarmActivated = ETrue;

    iAlarmDateTime = ThrowAwaySecondsAndMicroSecondsL( aAlarmTime );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetAlarmOffL

// Turns off the alarm.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetAlarmOffL()

    {

    TRACE_ENTRY_POINT;

    iIsAlarmActivated = EFalse;

    iAlarmDateTime = Time::NullTTime();

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------

// CCalenEntryUtil::SetAlarmDateTimeL

// Sets the alarm to be at the given time. Note that you must call SetAlarmOnL()

// before calling this function.

// (other items were commented in a header).

// -----------------------------------------------------------------------------

//

EXPORT_C void CCalenEntryUtil::SetAlarmDateTimeL( const TTime& aTime )

    {

    TRACE_ENTRY_POINT;

    __ASSERT_ALWAYS( iIsAlarmActivated, User::Leave( KErrNotReady ) );

    iAlarmDateTime = ThrowAwaySecondsAndMicroSecondsL( aTime );

    TRACE_EXIT_POINT;

    }

// -----------------------------------------------------------------------------