/*

* Copyright (c) 2008 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:  For Event view container of calendar application.

*                The class derived from CCalenContainer

*

*/

#ifndef CALENEVENTVIEWCONTAINER_H

#define CALENEVENTVIEWCONTAINER_H

// system includes

// user includes

#include "calenentryutil.h"

#include "calencontainer.h"

#include <eikmenup.h>

#include <cenrepnotifyhandler.h>

#include <eiklabel.h>

#include <AknServerApp.h>

// forward declarations

class CEikRichTextEditor;

class CCalenEntryUtil;

class CCalenIconDrawer;

class CItemFinder;

class CRepository;

class CCenRepNotifyHandler;

class CFindItemMenu;

class CCalCalendarInfo;

class CCalenIconDrawer;

class CDocumentHandler;

// class declaration

/**

 * CCalenEventContainer container control class for EventView.

 */

NONSHARABLE_CLASS(CCalenEventViewContainer):public CCalenContainer,

											public MCenRepNotifyHandlerCallback,

											public MEikScrollBarObserver,

											public MAknServerAppExitObserver

	{

public:

	/**

     * C++ constructor.

     */

    CCalenEventViewContainer( CCalenNativeView* aView,

                              MCalenServices& aServices );

    /**

     * Destructor.

     */

    virtual ~CCalenEventViewContainer();                     

private: // Functions from base classes

    /**

     * From CCoeControl, child control was resized.

     */

    void SizeChanged();

    /**

     * From CCoeControl, return child control count.

     * @return Control count

     */

    TInt CountComponentControls() const;

    /**

     * From CCoeControl, return child control pointer.

     * @param aIndex Child control index

     * @return Child control pointer.

     */

    CCoeControl* ComponentControl(TInt aIndex) const;

    /**

     * From CCoeControl, process key event.

     * @param aKeyEvent The key event.

     * @param aType EEventKey | EEventKeyUp | EEventKeyDown.

     * @return EKeyWasNotConsumed : Key event was not consumed.

     */

    TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent,

                                    TEventCode aType);

    /**

     * From CCoeControl, process pointer event.

     */

    void HandlePointerEventL(const TPointerEvent& aPointerEvent);

   /**

    * From CCoeControl

    */  

    void Draw(const TRect& /*aRect*/) const;

    /**

     * Pass skin information if needed

     */

    TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

    /**

     * From CCoeControl, Get help context.

     * @param aContext Help context

     */

    void GetHelpContext(TCoeHelpContext& aContext) const;

    /**

     * From MActiveStep, refresh EventView data.

     */

    TInt DoStepL();

    /**

     * From CCoeControl Handles a resource relative event.

     * 

     * @param aType The type of change that occured.

     */

    void HandleResourceChange(TInt aType);                              

private:    // From CCalenContainer

    /**

     * From CCalenContainer Third phase constructor.

     * This function was called CCalenView::ConstructL().

     */

    void ConstructImplL();

    /**

     * From CCalenContainer.

     * This methods is called after calendar settings have changed.

     */

    void UpdateSize();

    /**

     * Create icon index

     */

    void CreateIconIndicesL( RArray<MCalenServices::TCalenIcons>& aIndexArray );

    /**

     * This method is called after pointer event in Navi

     * decoration object.

     * @param aDirection right or left

     */

    void HandleNaviDecoratorEventL(TInt aEventID);

    void HandleLongTapEventL( const TPoint& aPenEventLocation, 

                              const TPoint& aPenEventScreenLocation );

public: // from MAknServerAppExitObserver

        /**

        * Handle the exit of a connected server app.

        * This implementation provides S60 default behavior

        * for handling of the EAknCmdExit exit code. Derived classes

        * should base-call this implementation if they override this

        * function.

        *

        * @since S60 5.0

        *

        * @param aReason The reason that the server application exited.

        * This will either be an error code, or the command id that caused

        * the server app to exit.

        */

        void HandleServerAppExit( TInt aReason );

		void HandleLocaleChangedL(/* TInt aReason */);

public: // New methods

    CCalInstance* FindPossibleInstanceL(const TCalenInstanceId& aId,

                                         CCalInstanceView& aInstanceView );

 	/**

 	 * Build text editor

 	 */

 	void BuildTextEditorL();

 	/**

 	 * Request for instance view

 	 */

 	TInt RequestInstanceViewL();

 	/**

 	 * Add the data fields

 	 */ 

 	void AddFieldsL();

    /**

     * Complete population

  	 */	

    void CompletePopulationL();

    /**

     * Getter for titlepane

     */ 	

 	TInt GetTitleTextId();

    /**

	 * Getter for event view data

	 */	

 	CCalenEntryUtil* GetEventViewData();

    /**

     * Complete a todo entry

     */

    void OnCmdCompleteTaskL();

    /**

     * Restore a todo entry

     */

    void OnCmdRestoreTaskL();

    /**

     * Get item finder

     */

    CItemFinder* GetItemFinder();

    /**

     * Get find item menu

     */

    CFindItemMenu* GetFindItemMenu();

    /**

     * Returns ETrue if event has geo coordinates else EFalse

     */

    TBool IsEventHasMapLocationL();

    /**

     * Returns ETrue if event has location text else EFalse

     */

    TBool IsEventHasNoLocationTextL();

 private:

 	/**

 	 * Set the layout data for LAF

 	 */

 	void SetLayoutFromLookAndFeelL(); 	

    /**

     * Convert values from twips to pixels

    */

    TInt PixelsToTwips(TInt aPixels);

 	/**

 	 * Set up the Font style

 	 */

 	void SetupFontL(); 	

	/**

	* Creates and initiliazes the icon drawer

	* Returns the newly created pointer to the object of CCalenIconDrawer

	*/

 	CCalenIconDrawer* CreateAndInitializeIconsDrawerL();

  /**

   * Set the icons

   */	

 	void SetIconsL(CCalenIconDrawer* aIconDrawer);

 	/**

     * Populate the icon drawer with the icons for this entry

     */

    void PopulateIconDrawerL( CCalenIconDrawer& aIconDrawer );

	/**

	* Calculates the number of lines before the location field in the document

	* so that map icon is placed at correct place

	**/

    void CalcNumOfLinesBeforeLocation();

    /**

     * Formats the heading and adds it the the view

     * Headings are bolded with no indentation.

     */

    void SetFormatAndAddHeadingL( const TDesC& aHeading );

    /**

     * Formats the body and adds it the the view

     * Body text is not bolded and indented from the leading margin

     * according to the Calendar viewer LAF

     */

    void SetFormatAndAddBodyL( const TDesC& aBody );

    /**

     * Formats the text and adds it to the view

     */

    void AddFormattedTextL( const TDesC& aText );

    /**

     * Add a text field to the view.

     */

    void AddTextFieldL( TInt aHeadingResource, const TDesC& aBody );

    /**

     * Add a text field to the view.

     */

    void AddTextFieldL( TInt aHeadingResource, TInt aBodyResource );

    /**

     * Add a empty line to the view.

     */

    void AddEmptyLineL();

    /**

     * Add a subject field to the view.

     */

    void AddSubjectFieldL();

    /**

     * Add a location field to the view.

     */

    void AddLocationFieldL();

    /**

     * Add a priority field to the form.

     */

    void AddPriorityFieldL();

    /**

     * Add a time field to the form.

     */

    void AddTimeFieldL( TInt aHeadingResource, const TTime& aTime );

    /**

     * Add a date field to the form.

     */

    void AddDateFieldL( const TTime& aDate );

    /**

     * Add a date field to the form.

     */

    void AddDateFieldL( TInt aHeadingResource, const TTime& aDate );

    /**

     * Add a "date - date" field to the form.

     */

    void AddDateDateFieldL( const TTime& aStartDate, const TTime& aEndDate );

    /**

     * Add an alarm date-time field to the form, in the order: DD.DD.DDDD TT:TT according to localisation.

     */

    void AddAlarmDateAndTimeFieldL( const TTime& aTime );

    /**

     * Set alarm to form.

     */

    void AddAlarmDateTimeFieldL();

    /**

     * Add the repeat information to the form for a recurring appointment

     * @since Series 60 3.1

     */

    void AddRepeatFieldL();

    /**

     * Add the time fields to the form

     * @since Series 60 3.1

     */

    void AddTimeFieldL();

    /**

     * Add a description to the form

     * @since Series 60 3.1

     */

    void AddDescriptionFieldL();

    /**

     * Add a since field to the form

     * @since Series 60 3.1

     */

    void AddSinceFieldL();

	/**

	* Adds the attachments names to the viewer

	*/

    void AddAttachmentNameL(const TDesC& aText);

   /**

    * Getter for min and max times

    */ 

    void GetMinAndMaxTimesL( RArray<TCalTime>& aTimes,

                         TCalTime& aMinTime,

                         TCalTime& aMaxTime );

   /**

    * Remove duplicate times

    */ 	

    void RemoveDuplicateTimesL( RArray<TCalTime>& aTimes );  

   /**

    * Remove excluded times

    */  

    void RemoveExcludedTimesL( RArray<TCalTime>& aStartDates,

                               RArray<TCalTime>& aExDates,

                               RPointerArray<CCalEntry>& aChildEntries );                          

   /**

    * RDate expansion stuff

    */	

	TBool GetSeriesRepeatInformationL( CCalEntry& aEntry,

	                                   TCalenRepeatIndex& aRepeatIndex,

	                                   TTime& aSeriesStart,

	                                   TTime& aSeriesEnd );

    /**

     * Check if the given text will fit in the the given width

     * Used to determine if dates will wrap or not

     */

    TBool TryToFitL( const TDesC& aStr, TInt aMaxWidth, const CFont& aFont );

    /**

     * Convert from a calendar TUint priority to a TInt for the form.

     */

    TInt CalendarPriorityToFormPriority( CCalenEntryUtil::TTodoPriority aCalPriority );	

   /**

    * Build Search Buffer

    */ 

    void BuildSearchBufferL();

    /**

     * Get the text fields from the form as a descriptior.

     */

    void GetTextFieldsFromFormL( TDes& aDesc );

    /**

     * Fetch the current entry's parent from agenda. This should be used

     * sparingly as it is expensive. It may be worth seeing if there

     * is any performance improvement by fetching the parent from

     * CCalenDefaultViewers and passing it through to the constructor of

     * the editors and viewers, instead of fetching it internally to each

     * viewer/editor.

     */

    CCalEntry& ParentEntryL();

    /**

     * Fetch all the instances of an entry from agenda. This should be used

     * sparingly as it is expensive. It may be worth seeing if there

     * is any performance improvement by fetching the parent from

     * CCalenDefaultViewers and passing it through to the constructor of

     * the editors and viewers, instead of fetching it internally to each

     * viewer/editor.

     */

    RPointerArray<CCalEntry>& AllInstancesL();

    /**

      * Get the available label rect for this container

      */

     TRect GetLabelRectL( );    

     void SetLabelContentL( CEikLabel& aLabel );

    /**

    * From MCenRepNotifyHandlerCallback

    * Handles the notifier errors

    * @since Series60 3.0

    * @param aId, Key that has changed

    * @param aNewValue, New value of the key    

    */

    void HandleNotifyError( TUint32 aId,TInt aError,CCenRepNotifyHandler* aHandler );

    /**

     * Add calendar info field to the viewer

     */

    void AddCalendarInfoFieldL();

    /**

     * Adds the attachment field in the viewer

     */

    void AddAttachmentFieldL();

	/**

	* Checks if user has tapped on the attahcment names and then opens the corresponding 

	* attachment

	*/

    void CheckAndOpenTappedAttachment(TTmPosInfo2* posInfo);

	/**

	* Opens the respective atatchment tapped

	*/

    void OpenViewerL(TInt attachmentToBeOpened);

    /**

     * Opens the attachment  

     * 

     * @param RFile File handler to be opened

     * @param aExitObserver Exit observer that listens for exiting from the attahcment viewer

     * @return None

     */

     void OpenAttachmentViewerL(RFile& file, MAknServerAppExitObserver& aExitObserver);

public:

    /**

     * From MEikScrollBarObserver: to Handle scrollbar events

     * @param CEikScrollBar* : Pointer to the scrollbar

     * @param TEikScrollEvent : Event on the Scrollbar

     */

     void HandleScrollEventL(CEikScrollBar* aScrollBar, TEikScrollEvent aEventType);

	 /**

     * Overridden HandleStopCommandL()from base class CCalenContainer.h