1 /*

     2 * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Implementation of Calendar services

    15 *

    16 */

    17 

    18 #include <gulicon.h>

    19 #include <calcalendarinfo.h>

    20 #include <mcalenpreview.h>

    21 

    22 #include "calenglobaldata.h"

    23 #include "calendarui_debug.h"

    24 #include "calenservicesimpl.h"

    25 #include "calencontroller.h"

    26 #include "calenviewmanager.h"

    27 #include "calenicons.h"

    28 #include "calenattachmentmodel.h"

    29 

    30 // ----------------------------------------------------------------------------

    31 // CCalenServicesImpl::NewL

    32 // Two phased constructor.

    33 // Taking the command range start and end points

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

    35 // ----------------------------------------------------------------------------

    36 //

    37 CCalenServicesImpl* CCalenServicesImpl::NewL( TInt aCommandRangeStart,

    38                                                                   TInt aCommandRangeEnd )

    39     {

    40     TRACE_ENTRY_POINT;

    41     CCalenServicesImpl* self = new( ELeave ) CCalenServicesImpl(

    42                                        aCommandRangeStart, aCommandRangeEnd );

    43 

    44     CleanupStack::PushL( self );

    45     self->ConstructL();

    46     CleanupStack::Pop( self );

    47 

    48     TRACE_EXIT_POINT;

    49     return self;

    50     }

    51 

    52 // ----------------------------------------------------------------------------

    53 // CCalenServicesImpl::NewL

    54 // 1st phase of construction.

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

    56 // ----------------------------------------------------------------------------

    57 //

    58 CCalenServicesImpl* CCalenServicesImpl::NewL()

    59     {

    60     TRACE_ENTRY_POINT;

    61     CCalenServicesImpl* self = new( ELeave ) CCalenServicesImpl( 0, 0 );

    62 

    63     CleanupStack::PushL( self );

    64     self->ConstructL();

    65     CleanupStack::Pop( self );

    66 

    67     TRACE_EXIT_POINT;

    68     return self;

    69     }

    70 

    71 // ----------------------------------------------------------------------------

    72 // CCalenServicesImpl::CCalenServicesImpl

    73 // C++ constructor.

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

    75 // ----------------------------------------------------------------------------

    76 //

    77 CCalenServicesImpl::CCalenServicesImpl( TInt aCommandRangeStart,

    78                                                         TInt aCommandRangeEnd )

    79     : iCommandRangeStart( aCommandRangeStart ),

    80       iCommandRangeEnd( aCommandRangeEnd )

    81     {

    82     TRACE_ENTRY_POINT;

    83     TRACE_EXIT_POINT;

    84     }

    85 

    86 // ----------------------------------------------------------------------------

    87 // CCalenServicesImpl::ConstructL

    88 // 2nd phase of construction.

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

    90 // ----------------------------------------------------------------------------

    91 //

    92 void CCalenServicesImpl::ConstructL()

    93     {

    94     TRACE_ENTRY_POINT;

    95 

    96     iGlobalData = CCalenGlobalData::InstanceL();

    97     iController = CCalenController::InstanceL();

    98 

    99     TRACE_EXIT_POINT;

   100     }

   101 

   102 // ----------------------------------------------------------------------------

   103 // CCalenServicesImpl::Release

   104 // Performs cleanup of this object.

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

   106 // ----------------------------------------------------------------------------

   107 //

   108 void CCalenServicesImpl::Release()

   109     {

   110     TRACE_ENTRY_POINT;

   111 

   112     if( iGlobalData )

   113         {

   114         iGlobalData->Release();

   115         }

   116 

   117     if( iController )

   118         {

   119         iController->Release();

   120         }

   121 

   122     delete this;

   123 

   124     TRACE_EXIT_POINT;

   125     }

   126 

   127 // ----------------------------------------------------------------------------

   128 // CCalenServicesImpl::SessionL

   129 // Retrieve the calendar session currently in use by Calendar

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

   131 // ----------------------------------------------------------------------------

   132 //

   133 CCalSession& CCalenServicesImpl::SessionL()

   134     {

   135     TRACE_ENTRY_POINT;

   136 

   137     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   138 

   139     TRACE_EXIT_POINT;

   140     return iGlobalData->CalSessionL();

   141     }

   142 

   143 // ----------------------------------------------------------------------------

   144 // CCalenServicesImpl::EntryViewL

   145 // Retrieve the calendar entry view currently in use by Calendar

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

   147 // ----------------------------------------------------------------------------

   148 //

   149 CCalEntryView* CCalenServicesImpl::EntryViewL()

   150     {

   151     TRACE_ENTRY_POINT;

   152 

   153     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   154 

   155     TRACE_EXIT_POINT;

   156     return iGlobalData->EntryViewL();

   157     }

   158 

   159 // ----------------------------------------------------------------------------

   160 // CCalenServicesImpl::InstanceViewL

   161 // Retrieve the calendar instance view currently in use by Calendar

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

   163 // ----------------------------------------------------------------------------

   164 //

   165 CCalInstanceView* CCalenServicesImpl::InstanceViewL()

   166     {

   167     TRACE_ENTRY_POINT;

   168 

   169     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   170 

   171     TRACE_EXIT_POINT;

   172     return iGlobalData->InstanceViewL();

   173     }

   174 

   175 // ----------------------------------------------------------------------------

   176 // CCalenServicesImpl::InterimUtilsL()

   177 // Retrieve interimutils from globaldata

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

   179 // ----------------------------------------------------------------------------

   180 //

   181 CCalenInterimUtils2& CCalenServicesImpl::InterimUtilsL()

   182     {

   183     TRACE_ENTRY_POINT;

   184     TRACE_EXIT_POINT;

   185     return iGlobalData->InterimUtilsL();

   186     }

   187 

   188 // ----------------------------------------------------------------------------

   189 // CCalenServicesImpl::RegisterForNotificationsL

   190 // Register for notification of Calendar event

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

   192 // ----------------------------------------------------------------------------

   193 //

   194 void CCalenServicesImpl::RegisterForNotificationsL( MCalenNotificationHandler* aHandler,

   195                                                             TCalenNotification aNotification )

   196     {

   197     TRACE_ENTRY_POINT;

   198 

   199     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   200     iController->RegisterForNotificationsL( aHandler, aNotification );

   201 

   202     TRACE_EXIT_POINT;

   203     }

   204 

   205 // ----------------------------------------------------------------------------

   206 // CCalenServicesImpl::RegisterForNotificationsL

   207 // Register for array notifications of Calendar events

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

   209 // ----------------------------------------------------------------------------

   210 //

   211 void CCalenServicesImpl::RegisterForNotificationsL( MCalenNotificationHandler* aHandler,

   212                                                             RArray<TCalenNotification>& aNotifications )

   213     {

   214     TRACE_ENTRY_POINT;

   215 

   216     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   217     iController->RegisterForNotificationsL( aHandler, aNotifications );

   218 

   219     TRACE_EXIT_POINT;

   220     }

   221 

   222 // ----------------------------------------------------------------------------

   223 // CCalenServicesImpl::CancelNotifications

   224 // Cancel notifications of Calendar events

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

   226 // ----------------------------------------------------------------------------

   227 //

   228 void CCalenServicesImpl::CancelNotifications( MCalenNotificationHandler* aHandler )

   229     {

   230     TRACE_ENTRY_POINT;

   231 

   232     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   233     iController->CancelNotifications( aHandler );

   234 

   235     TRACE_EXIT_POINT;

   236     }

   237 

   238 // ----------------------------------------------------------------------------

   239 // CCalenServicesImpl::IssueCommandL

   240 // Issue a command to be handled by Calendar or a customization

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

   242 // ----------------------------------------------------------------------------

   243 //

   244 TBool CCalenServicesImpl::IssueCommandL( TInt aCommand )

   245     {

   246     TRACE_ENTRY_POINT;

   247     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   248 

   249     TRACE_EXIT_POINT;

   250     return iController->IssueCommandL( aCommand );

   251     }

   252 

   253 // ----------------------------------------------------------------------------

   254 // CCalenServicesImpl::IssueNotificationL

   255 // Issue a notification to Calendar, which will be broadcast synchronously

   256 // to all registered notification handlers

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

   258 // ----------------------------------------------------------------------------

   259 //

   260 void CCalenServicesImpl::IssueNotificationL( TCalenNotification aNotification )

   261     {

   262     TRACE_ENTRY_POINT;

   263 

   264     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   265     iController->BroadcastNotification( aNotification );

   266 

   267     TRACE_EXIT_POINT;

   268     }

   269 

   270 // ----------------------------------------------------------------------------

   271 // CCalenServicesImpl::Context

   272 // Returns the context.

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

   274 // ----------------------------------------------------------------------------

   275 //

   276 MCalenContext& CCalenServicesImpl::Context()

   277     {

   278     TRACE_ENTRY_POINT;

   279 

   280     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   281 

   282     TRACE_EXIT_POINT;

   283     return iGlobalData->Context();

   284     }

   285 

   286 // ----------------------------------------------------------------------------

   287 // CCalenServicesImpl::RequestActivationL

   288 // Request activation of a specific view

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

   290 // ----------------------------------------------------------------------------

   291 //

   292 void CCalenServicesImpl::RequestActivationL( const TVwsViewId& aViewId )

   293     {

   294     TRACE_ENTRY_POINT;

   295 

   296     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   297     iController->RequestActivationL( aViewId );

   298 

   299     TRACE_EXIT_POINT;

   300     }

   301 

   302 // ----------------------------------------------------------------------------

   303 // CCalenServicesImpl::ActivationNotificationL

   304 // Notify Calendar that a specific view has been activated

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

   306 // ----------------------------------------------------------------------------

   307 //

   308 void CCalenServicesImpl::ActivationNotificationL( const TVwsViewId& /*aViewId*/ )

   309     {

   310     TRACE_ENTRY_POINT;

   311 

   312     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   313 

   314     TRACE_EXIT_POINT;

   315     }

   316 

   317 // ----------------------------------------------------------------------------

   318 // CCalenServicesImpl::OfferMenuPaneL

   319 // Offers the menu pane to plugins for customisation

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

   321 // ----------------------------------------------------------------------------

   322 //

   323 void CCalenServicesImpl::OfferMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane )

   324     {

   325     TRACE_ENTRY_POINT;

   326 

   327     iController->OfferMenuPaneL( aResourceId, aMenuPane );

   328 

   329     TRACE_EXIT_POINT;

   330     }

   331 

   332 // ----------------------------------------------------------------------------

   333 // CCalenServicesImpl::GetCommandRange

   334 // Returns the assigned command range

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

   336 // ----------------------------------------------------------------------------

   337 //

   338 void CCalenServicesImpl::GetCommandRange( TInt& aCommandRangeStart, 

   339         TInt& aCommandRangeEnd ) const

   340     {

   341     TRACE_ENTRY_POINT;

   342 

   343     aCommandRangeStart = iCommandRangeStart;

   344     aCommandRangeEnd = iCommandRangeEnd;

   345 

   346     TRACE_EXIT_POINT;

   347     }

   348 

   349 // ----------------------------------------------------------------------------

   350 // CCalenServicesImpl::Infobar

   351 // Descriptor passed to plugins to get customised info bar text

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

   353 // ----------------------------------------------------------------------------

   354 //

   355 CCoeControl* CCalenServicesImpl::Infobar(const TRect& aRect )

   356     {

   357     TRACE_ENTRY_POINT;

   358 

   359     TRACE_EXIT_POINT;

   360     return iController->Infobar( aRect );

   361     }

   362 

   363 // ----------------------------------------------------------------------------

   364 // CCalenServicesImpl::Infobar

   365 // Returns the customized text from plugin

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

   367 // ----------------------------------------------------------------------------

   368 //

   369 const TDesC& CCalenServicesImpl::Infobar()

   370     {

   371     TRACE_ENTRY_POINT;

   372     TRACE_EXIT_POINT;

   373     return iController->Infobar();

   374     }

   375 

   376 // ----------------------------------------------------------------------------

   377 // CCalenServicesImpl::CustomPreviewPaneL

   378 // Returns the customized Preview pane

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

   380 // ----------------------------------------------------------------------------

   381 //

   382 MCalenPreview* CCalenServicesImpl::CustomPreviewPaneL( TRect& aRect )

   383 	{

   384     TRACE_ENTRY_POINT;

   385     TRACE_EXIT_POINT;

   386     return iController->CustomPreviewPaneL( aRect );	

   387 	}

   388 

   389 // ----------------------------------------------------------------------------

   390 // CCalenServicesImpl::PreviewPane

   391 // Descriptor passed to plugins to get customised info bar text

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

   393 // ----------------------------------------------------------------------------

   394 //

   395 CCoeControl* CCalenServicesImpl::PreviewPane( TRect& aRect )

   396     {

   397     TRACE_ENTRY_POINT;

   398 

   399     TRACE_EXIT_POINT;

   400     return iController->PreviewPane( aRect );

   401     }

   402 

   403 // ----------------------------------------------------------------------------

   404 // CCalenServicesImpl::ToolbarOrNull

   405 // Provides access to the calendar toolbar if one is available

   406 // ----------------------------------------------------------------------------

   407 MCalenToolbar* CCalenServicesImpl::ToolbarOrNull()

   408     {

   409     TRACE_ENTRY_POINT;

   410 

   411     TRACE_EXIT_POINT;

   412     return iController->ViewManager().ToolbarOrNull();

   413     }

   414     

   415 // ----------------------------------------------------------------------------

   416 // CCalenServicesImpl::GetIconL

   417 // Get icon of specific type

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

   419 // ----------------------------------------------------------------------------

   420 //

   421 CGulIcon* CCalenServicesImpl::GetIconL( MCalenServices::TCalenIcons aIndex )

   422     {

   423     TRACE_ENTRY_POINT;

   424 

   425     TRACE_EXIT_POINT;

   426     return iController->GetIconL( aIndex );

   427     }

   428 

   429 // ----------------------------------------------------------------------------

   430 // CCalenServicesImpl::QueueKeyEvent

   431 // Queue key events

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

   433 // ----------------------------------------------------------------------------

   434 //

   435 TBool CCalenServicesImpl::QueueKeyEvent( const TKeyEvent& aEvent, 

   436                                                            TEventCode aType )

   437     {

   438     TRACE_ENTRY_POINT;

   439 

   440     TRACE_EXIT_POINT;

   441     return iGlobalData->QueueKeyEvent( aEvent, aType );

   442     }

   443 

   444 // ----------------------------------------------------------------------------

   445 // CCalenServicesImpl::GetQueuedKeyEventL

   446 // Get queued key events

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

   448 // ----------------------------------------------------------------------------

   449 //    

   450 TBool CCalenServicesImpl::GetQueuedKeyEvent( TKeyEvent& aEvent, 

   451                                                                   TEventCode& aType )

   452     {

   453     TRACE_ENTRY_POINT;

   454 

   455     TRACE_EXIT_POINT;

   456     return iGlobalData->GetQueuedKeyEvent( aEvent, aType );

   457     }

   458 

   459 // ----------------------------------------------------------------------------

   460 // CCalenServicesImpl::ResetKeyEventQueue

   461 // reset key event queue

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

   463 // ----------------------------------------------------------------------------

   464 //    

   465 void CCalenServicesImpl::ResetKeyEventQueue()

   466     {

   467     TRACE_ENTRY_POINT;

   468 

   469     iGlobalData->ResetKeyEventQueue();

   470 

   471     TRACE_EXIT_POINT;

   472     }

   473 

   474 // ----------------------------------------------------------------------------

   475 // CCalenController::MissedAlarmStore

   476 // Returns a reference to the Missed Alarm Store

   477 // ----------------------------------------------------------------------------

   478 CMissedAlarmStore* CCalenServicesImpl::MissedAlarmStore()

   479     {

   480     TRACE_ENTRY_POINT;

   481     TRACE_EXIT_POINT;

   482     return iController->MissedAlarmStore();

   483     }

   484 

   485 // ----------------------------------------------------------------------------

   486 // CCalenServicesImpl::GetMissedAlarmsList

   487 // Get missed alarms list

   488 // ----------------------------------------------------------------------------

   489 void CCalenServicesImpl::GetMissedAlarmsList(RArray<TCalenInstanceId>& aMissedAlarmsList)

   490     {

   491     TRACE_ENTRY_POINT;

   492     TRACE_EXIT_POINT;

   493     return iController->GetMissedAlarmsList(aMissedAlarmsList);

   494     }

   495 

   496 // ----------------------------------------------------------------------------

   497 // CCalenServicesImpl::GetAttachmentData

   498 // returns ref of CCalenAttachmentModel

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

   500 // ----------------------------------------------------------------------------

   501 // 

   502 CCalenAttachmentModel* CCalenServicesImpl::GetAttachmentData()

   503     {

   504     TRACE_ENTRY_POINT;

   505     TRACE_EXIT_POINT;

   506     return &iController->AttachmentData();

   507     }

   508 

   509 // ----------------------------------------------------------------------------

   510 // CCalenServicesImpl::SessionL

   511 // Retrieve the calendar session currently in use by Calendar

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

   513 // ----------------------------------------------------------------------------

   514 //

   515 CCalSession& CCalenServicesImpl::SessionL(const TDesC& aCalendar )

   516     {

   517     TRACE_ENTRY_POINT;

   518 

   519     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   520 

   521     TRACE_EXIT_POINT;

   522     return iGlobalData->CalSessionL(aCalendar);

   523     }

   524 

   525 // ----------------------------------------------------------------------------

   526 // CCalenServicesImpl::EntryViewL

   527 // Retrieve the calendar entry view currently in use by Calendar

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

   529 // ----------------------------------------------------------------------------

   530 //

   531 CCalEntryView* CCalenServicesImpl::EntryViewL(const  TCalCollectionId aCollectionId )

   532     {

   533     TRACE_ENTRY_POINT;

   534 

   535     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   536 

   537     TRACE_EXIT_POINT;

   538     return iGlobalData->EntryViewL(aCollectionId);

   539     }

   540 

   541 // ----------------------------------------------------------------------------

   542 // CCalenServicesImpl::InstanceViewL

   543 // Retrieve the calendar instance view currently in use by Calendar

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

   545 // ----------------------------------------------------------------------------

   546 //

   547 CCalInstanceView* CCalenServicesImpl::InstanceViewL(

   548                                         const RArray<TInt>& aCollectionIds)

   549     {

   550     TRACE_ENTRY_POINT;

   551 

   552     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   553 

   554     TRACE_EXIT_POINT;

   555     return iGlobalData->InstanceViewL(aCollectionIds);

   556     }

   557 

   558 // -----------------------------------------------------------------------------

   559 // CCalenGlobalData::GetAllCalendarInfoL

   560 // Get all available calendar info

   561 // -----------------------------------------------------------------------------

   562 //

   563 void CCalenServicesImpl::GetAllCalendarInfoL(

   564         RPointerArray<CCalCalendarInfo>& aCalendarInfoList )

   565     {

   566     TRACE_ENTRY_POINT;

   567     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   568     iGlobalData->GetAllCalendarInfoL(aCalendarInfoList);

   569     TRACE_EXIT_POINT;

   570     }

   571 

   572 // -----------------------------------------------------------------------------

   573 // CCalenGlobalData::GetCalFileNameForCollectionId

   574 // Get calendar file name for the given collection id

   575 // -----------------------------------------------------------------------------

   576 //

   577 const TDesC& CCalenServicesImpl::GetCalFileNameForCollectionId(

   578         const TCalCollectionId aCollectionId)

   579     {

   580     TRACE_ENTRY_POINT;

   581     ASSERT( iGlobalData && iController ); // Make sure ConstructL has been called.

   582     TRACE_EXIT_POINT;

   583     return iGlobalData->GetCalFileNameForCollectionId(aCollectionId);

   584     }

   585 

   586 // End of file