/*

* Copyright (c) 2007-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:  Interface definition for ESMR meeting request entry

*

*/

#ifndef MESMRMEETINGREQUESTENTRY_H

#define MESMRMEETINGREQUESTENTRY_H

//<cmail>

#include "mesmrcalentry.h"

#include "esmrdef.h"

//</cmail>

class CCalAttendee;

class MMRInfoObject;

class TESMRInputParams;

class CMRMailboxUtils;

/**

 * MESMRCalEntry provides utility functions for handling MR Entry.

 *

 * @lib esmrservices.lib

 */

class MESMRMeetingRequestEntry : public MESMRCalEntry

    {

public:

    /** Enumeration for meeting request entry information */

    enum TESMREntryInfo

        {

        EESMREntryInfoOutOfDate,            // Entry is ouyt of date

        EESMREntryInfoCancelled,            // Entry is cancelled

        EESMREntryInfoAccepted,             // Entry is accepted

        EESMREntryInfoTentativelyAccepted,  // Entry is tentatively accepted

        EESMREntryInfoDeclined,             // Entry is declined

        EESMREntryInfoOccursInPast,         // Entry occurs in past

        EESMREntryInfoConflicts,            // Entry conflicts with another entry

        EESMREntryInfoNormal                // Normal case

        };

public:

    /**

     * Virtual destructor.

     */

    virtual ~MESMRMeetingRequestEntry() { }

public:

    /**

     * Tests whether entry is sent or not

     */

    virtual TBool IsSentL() const = 0;

    /**

     * Fetches the phone owner's role in this calendar entry.

     * @return User role.

     * @see TESMRRole.

     */

    virtual TESMRRole RoleL() const = 0;

    /**

     * Checks, if this entry conflicts with other entries.

     * @return ETrue, if conflicts exists.

     */

    virtual TBool Conflicts() const = 0;

    /**

     * For organizer, this marks meeting cancelled.

     * For attendee, this constructs response entry

     * and marks attendee status 'declined'.

     */

    virtual void MarkMeetingCancelledL() = 0;

    /**

     * Constructs reply entry and sets attendee status.

     * Phone owner needs to be found from entrys attendee list

     * and role needs to be participant or optional participant.

     *

     * @param aStatus Attendee status

     */

    virtual void ConstructReplyL(

            TESMRAttendeeStatus aStatus ) = 0;

    /**

     * Tests, whether entry is out of date. Entry is out of date, if

     * newer entry exists in calendar db.

     * @return ETrue, if entry is out of date.

     */

    virtual TBool IsEntryOutOfDateL() const = 0;

    /**

     * Tests, if meeting is cancelled.

     * @return ETrue, if meeting is cancelled.

     */

    virtual TBool IsMeetingCancelledL() const = 0;

    /**

     * Fetches attendee status. Phone owner needs to be in the attendee

     * list.

     * @return Attendee status.

     * @error KErrNotFound if phone owner not found from attendee list.

     */

    virtual TESMRAttendeeStatus AttendeeStatusL() const = 0;

    /**

     * Tests if this is forwarded entry.

     * @return ETrue, if entry is forwarded.

     */

    virtual TBool IsForwardedL() const = 0;

    /**

     * Switched entry into forward mode. Current entry's all fields remain

     * as they are.Entry's method is switched into request and attendee

     * list is emptied.

     * @error KErrNotSupported Current entry cannot be forwarded.

     */

    virtual void SwitchToForwardL() = 0;

    /**

     * Switched entry into orginal mode. Entry is restored to same state

     * before switching into forwarding mode.

     * @error KErrNotSupported Current entry cannot be forwarded.

     */

    virtual void SwitchToOrginalL() = 0;

    /**

     * Sets entry's status to confirmed.

     */

    virtual void ConfirmEntryL() = 0;

    /**

     * Checks, whether entry occurs in the past

     * @return ETrue, if entry occurs in the past.

     */

    virtual TBool OccursInPastL() const = 0;

    /**

     * Fetches entry information in attendee mode.

     * Method will leave if phone owner is organizer.

     * @return Entry attendee information

     * @error KErrNotSupported Phone owner is organizer.

     */

    virtual TESMREntryInfo EntryAttendeeInfoL() const = 0;

    /**

     * Fetches attendees from entry. Attendees are added to

     * aAttendeeArray. Attendees are filtered according to aFilterFlags

     * parameter.

     * Filtering flags is combimnation of enumeration TESMRRole values.

     * For example, aFilterFlags =  EESMRRoleRequiredAttendee --> Required

     * attendees are included to array. Ownership of the attendee objects is

     * not transferred.

     * @param aAttendeeArray Reference to attendee array

     * @param aFilterFlags Attendee filtering flags.

     */

    virtual void GetAttendeesL(

            RArray<CCalAttendee*>& aAttendeeArray,

            TUint aFilterFlags ) const = 0;

    /**

    * Fetches the conflicting entries. Conflicting entries are added

    * to aEntryArray.

    * @param aEntryArray Array containing conflicting entries

    * @return KErrNotFound if no conflicting entries, KErrNone otherwise.

    */

    virtual TInt FetchConflictingEntriesL(

            RPointerArray<CCalEntry>& aEntryArray ) = 0;

    /**

     * Tests if meeting request entry contains synchronization object.

     * @return ETrue, if sync object is present

     */

    virtual TBool IsSyncObjectPresent() const = 0;

    /**

     * Fetches the reference to sync object If sync object is not

     * present, method leaves with KErrNotSupported.

     */

    virtual MMRInfoObject& SyncObjectL() = 0;

    /**

     * Validates the sync object and return pointer to it. If sync object is not

     * present, method leaves with KErrNotSupported.

     */

    virtual MMRInfoObject& ValidateSyncObjectL() = 0;

    /**

     * Fetches startup parameters. Return ETrue if startup parameters

     * were filled to aStarupParams structure.

     * @param aStarupParams Reference to startup params structure

     * @return ETrue, if startup params were present

     */

    virtual TBool StartupParameters(

            TESMRInputParams& aStarupParams) const = 0;

    /**

     * Fetches attendee count.

     *

     * Filtering flags is combimnation of enumeration TESMRRole values.

     * For example, aFilterFlags =  EESMRRoleRequiredAttendee --> Required

     * attendee count is returns.

     *

     * @return Attendee count

     */

    virtual TInt AttendeeCountL(

            TUint aFilterFlags ) const = 0;

    /**

     * Tests, if entry is opened from mail.

     * @return ETrue if entry is opened from mail.

     */

    virtual TBool IsOpenedFromMail() const = 0;

    /**

     * Fetches attendees from entry. Attendees are added to

     * aAttendeeArray. Attendees are filtered according to aFilterFlags

     * parameter.

     * Filtering flags is combimnation of enumeration TESMRRole values.

     * For example, aFilterFlags =  EESMRRoleRequiredAttendee --> Required

     * attendees are included to array. Ownership of the attendee objects is

     * not transferred.

     * @param aAttendeeArray Reference to attendee array

     * @param aFilterFlags Attendee filtering flags.

     */

    virtual void GetAddedAttendeesL(

            RArray<CCalAttendee*>& aAttendeeArray,

            TUint aFilterFlags ) const = 0;

    /**

     * Fetches attendees from entry. Attendees are added to

     * aAttendeeArray. Attendees are filtered according to aFilterFlags

     * parameter.

     * Filtering flags is combimnation of enumeration TESMRRole values.

     * For example, aFilterFlags =  EESMRRoleRequiredAttendee --> Required

     * attendees are included to array. Ownership of the attendee objects is

     * not transferred.

     * @param aAttendeeArray Reference to attendee array

     * @param aFilterFlags Attendee filtering flags.

     */

    virtual void GetRemovedAttendeesL(

            RArray<CCalAttendee*>& aAttendeeArray,

            TUint aFilterFlags ) const = 0;

    /**

     * Updates child entries sequence numbers and stores them to

     * calendar DB.

     */

    virtual void UpdateChildEntriesSeqNumbersL() = 0;

    /**

     * Resolves current plugin in use.

     * @return current plug-in in use.

     */

    virtual TESMRMailPlugin CurrentPluginL() = 0;

    /**

     * Checks if any instance (having same UID)

     * occurs between specified time. Time information

     * is considered to be device's local time.

     *

     * @param aStart Start time

     * @param aEnd End time

     */

    virtual TBool AnyInstancesBetweenTimePeriodL(

            TTime& aStart,

            TTime& aEnd ) = 0;

    /**

     * Fetches first instances start and end time. For non-recurrent

     * entries this returns the entry's start and end time.

     *

     * @param aStart On returns contains the first instance's start time.

     * @param aEnd On returns contains the first instance's end time.

     */

    virtual void GetFirstInstanceStartAndEndTimeL(

            TTime& aStart,

            TTime& aEnd ) = 0;

    /**

     * Fetches the calendar owner address.

     * @return Calendar owner address

     */

    virtual const TDesC& CalendarOwnerAddressL() const = 0;

    /**

     * Gets the mailbox utils.

     */

    virtual CMRMailboxUtils& MailboxUtils() const = 0;

     /**

      *  check whether can send canellation

      */

     virtual TBool SendCanellationAvailable() = 0;

     /**

      * set the cannellation flag 

      */

     virtual void SetSendCanellationAvailable (TBool aSendCanellation) = 0;

    };

#endif // MESMREMEETINGREQUESTSENDER_H