--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/calendarui/views/inc/caleneventviewcontainer.h Tue Feb 02 10:12:19 2010 +0200
@@ -0,0 +1,614 @@
+/*
+* 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 );
+
+ /**
+ * Reads the shared data value used to initialize automatic highlighting
+ * @return TBool, ETrue if automatic highlighting is to be used
+ */
+ void ReadAutoHlCenRepValueAndSetNotifyL();
+
+ /**
+ * From MCenRepNotifyHandlerCallback
+ * Handles the incoming notifications of key changes
+ * @since Series60 3.0
+ * @param aId, Key that has changed
+ * @param aNewValue, New value of the key
+ */
+ void HandleNotifyInt( TUint32 aId, TInt aNewValue );
+
+ /**
+ * 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 );
+
+ /**
+ * Set the state of automatic highlighting
+ * @param aSwitchON, ETrue if automatic highlighting is to used, otherwise EFalse
+ */
+ void SetAutomaticHighlightL( const TBool aSwitchON );
+
+ /**
+ * This method is used when phone number is
+ * found and pressing phone key would make call
+ */
+ void HandleNumberCallL();
+
+ /**
+ * Add calendar info field to the viewer
+ */
+ void AddCalendarInfoFieldL();
+
+ /*
+ * @brief Find calendarinfo object based on calendar name
+ *
+ * @param aName calendar filename
+ * @param aCalendarInfo referance for calendarinfo
+ * @return TBool find status
+ */
+ static TBool CalendarInfoIdentifierL(const HBufC* aName,
+ const CCalCalendarInfo& aCalendarInfo);
+ /**
+ * 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
+ * To stop the alarm in auto snooze case.and to open the event viewer in normal mode.
+ */
+ void HandleStopCommandL();
+
+protected:
+
+ class TTextPos
+ {
+ public:
+ TInt iDocStart;
+ TInt iDocEnd;
+ };
+
+private:
+
+ HBufC* iSearchBuf; //Buffer for search text used by find api
+ HBufC* iTimeFormat; // buffer for the time format string
+ HBufC* iDateFormat; // buffer for the date format string
+
+ CParaFormat* iParaFormat; // para format for the rich text obj. owned
+ TParaFormatMask iParaFormatMask; // specifying validity of paraformat
+
+ TCharFormat iCharFormat; // character formating for the rich text obj
+ TCharFormatMask iCharFormatMask; // specifying validity of icharformat
+
+ TFontSpec iHeadingFontSpec; // font weight of heading text
+ TFontSpec iBodyFontSpec; // font weight of body text
+
+ const CFont* iBodyFont; // not owned
+ const CFont* iHeadingFont; // not owned
+ TInt iMaxWidth; // maximum width in pixel of text area of the rich text
+ TInt iHeadingIndent; // indent of the heading text measured in twips
+ TInt iBodyIndent; // indent of the body text measured in twips
+ TInt iIconDrawerWidthInPixels; // width of the icon drawer in pixels
+ TInt iEmptyLineHeight; // height of the empty line in twips
+
+ CEikRichTextEditor* iTextEditor; // rich text obj. owned
+ CAknsBasicBackgroundControlContext* iBgContext; // for skins support
+
+ CCalenEntryUtil* iEventViewData; // event view data
+
+ CCalEntry* iEntry; //entry viewed in event view
+ TInt iTitleTextId; // title pane text id
+
+ // The array of entries returned from FetchL(), based on the entry being edited.
+ // This allows retrieving of the parent entry using ParentEntryL(), which should
+ // be used instead of direct access to this array.
+ RPointerArray<CCalEntry> iFetchedEntries;
+
+private:
+ CRepository* iCenRepSession; // Central Repository session
+ // Notifier to listen changes of offline state
+ CCenRepNotifyHandler* iNotifier;
+ TInt iNumOfLinesBeforeLocField; // Number of lines before locaiton field in the rich text editor
+ TInt iTimeFieldLines; // Number of lines occupied by time field on the viewer
+ TBool iAutomaticHlValue;
+ TBool iAutomaticHlInitialized;
+ CItemFinder* iAutoFinder; // text finder
+ CFindItemMenu* iFindMenu;
+ TCursorSelection iSelectedText; // Cursor selection for the text editor
+ TBool iLocaleChanged;
+ CEikLabel* iLabel;
+ CDocumentHandler* iDocHandler;
+ RArray<TTextPos> iAttachmentPosInfoArray; // Array of start and end positions of each attachment names on the viewer
+
+ };
+
+#endif // CALENEVENTCONTAINER_H
\ No newline at end of file