1 /*

     2 * Copyright (c) 2007-2007 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:  CSC Applications AppUi

    15 *

    16 */

    17 

    18 

    19 #ifndef C_CSCAPPUI_H

    20 #define C_CSCAPPUI_H

    21 

    22 #include <aknViewAppUi.h>

    23 

    24 #include "mcscengcchobserver.h"

    25 #include "mcscengserviceobserver.h"

    26 #include "mcscengconnectionobserver.h"

    27 #include "mcscenguiextensionobserver.h"

    28 #include "mcscengprovisioningobserver.h"

    29 

    30 class CEikAppUi;

    31 class CAknViewAppUi;

    32 class CCSCServiceView;

    33 class CCSCEngCCHHandler;

    34 class CCSCEngStartupHandler;

    35 class CCSCEngServiceHandler;

    36 class CCSCEngBrandingHandler;

    37 class CCSCEngConnectionHandler;

    38 class CCSCEngServicePluginHandler;

    39 class CCSCEngUiExtensionPluginHandler;

    40 

    41 // View ID's for CSC views.

    42 const TUid KCSCServiceViewId = {947873};

    43 

    44  

    45 /**

    46  *  An instance of class CCSCAppUi.

    47  *  User Interface part of AVKON application framework for CSC application

    48  *

    49  *  @lib

    50  *  @since S60 v3.2

    51  */

    52 NONSHARABLE_CLASS( CCSCAppUi ) : public CAknViewAppUi,  

    53                                  public MCSCEngProvisioningObserver,

    54                                  public MCSCEngUiExtensionObserver,

    55                                  public MCSCEngConnectionObserver,

    56                                  public MCSCEngServiceObserver,

    57                                  public MCSCEngCCHObserver

    58     {

    59     public:

    60     

    61         void ConstructL();

    62 

    63         CCSCAppUi();

    64     

    65         

    66         /**

    67          * Destructor.

    68          */

    69         virtual ~CCSCAppUi();

    70         

    71         

    72         // from base class CEikAppUi

    73                 

    74         /**

    75          * From CEikAppUi 

    76          * 

    77          *

    78          * @since

    79          * @param aCommand Defines the command codes used to indicate the way

    80          * an application is to be launched. Not used in CSC.

    81          * @param aDocumentName A buffer that can contain the name of a file.

    82          * Used in CSC to pass startup parameters instead of file name.

    83          * @param aTail 

    84          */

    85         TBool ProcessCommandParametersL(

    86             TApaCommand aCommand,

    87             TFileName& aDocumentName,

    88             const TDesC8& aTail);

    89         

    90         

    91         /**

    92          * From CEikAppUi 

    93          * 

    94          *

    95          * @since

    96          * @param aUid

    97          * @param aParams startup parameters.

    98          */

    99         void ProcessMessageL( TUid aUid, const TDesC8 &aParams );

   100 

   101         // from base class CAknViewAppUi

   102     

   103         /**

   104          * From CAknViewAppUi 

   105          * Handles user menu selections.

   106          *

   107          * @since S60 v3.0

   108          * @param aCommand The enumerated code for the option selected

   109          */

   110         void HandleCommandL( TInt aCommand );

   111         

   112         

   113         /**

   114          * From CAknViewAppUi 

   115          * Handling changing of the skin and layout.

   116          *

   117          * @since S60 v3.0

   118          * @param aType for type of the change

   119          */

   120         void HandleResourceChangeL( TInt aType );

   121                 

   122         

   123         // from base class MCSCProvisioningObserver

   124         

   125         /**

   126          * From MCSCProvisioningObserver

   127          * Notifies when configuring of service plug-in is done.

   128          *

   129          * @since S60 v3.2

   130          * @param aResponse plug-in response type

   131          * @param aIndex index

   132          * @param aPluginUid plugins uid

   133          */

   134         void NotifyServicePluginResponse( 

   135             const CCSCEngServicePluginHandler::TServicePluginResponse& aResponse, 

   136             const TInt aIndex, 

   137             const TUid& aPluginUid );

   138         

   139         

   140          // from base class MCSCUiExtensionObserver

   141         

   142         /**

   143          * From MCSCUiExtensionObserver

   144          * Notifies when ui extension plug-in is exited

   145          *

   146          * @since S60 v3.2

   147          * @param aResponse plug-in response type

   148          * @param aIndex index

   149          * @param aPluginUid plugins uid

   150          */

   151         void NotifyUiExtensionPluginResponse(

   152             const CCSCEngUiExtensionPluginHandler::TUiExtensionPluginResponse&

   153             aResponse, 

   154             const TInt aIndex, 

   155             const TUid& aPluginUid );

   156         

   157          

   158         // from base class MCSCEngServiceObserver

   159         

   160          /**

   161          * Called when change in service(s) occur

   162          *

   163          * @since S60 v3.2

   164          */

   165         void NotifyServiceChange();

   166         

   167         

   168         // from base class MCSCEngCCHObserver

   169 

   170         /**

   171          * From MCSCEngCCHObserver.

   172          */

   173         void ServiceStatusChanged(

   174             TUint aServiceId, 

   175             TCCHSubserviceType aType, 

   176             const TCchServiceStatus& aServiceStatus );

   177         

   178         

   179         // from base class MCSCEngConnectionObserver

   180     

   181         /**

   182          * From MCSCEngConnectionObserver.

   183          */

   184         void NotifyConnectionEvent( 

   185             CCSCEngConnectionHandler::TConnectionEvent aConnectionEvent );

   186 

   187         /**

   188          * From MCoeMessageObserver.

   189          */

   190         MCoeMessageObserver::TMessageResponse HandleMessageL(

   191             TUint32 aClientHandleOfTargetWindowGroup, TUid aMessageUid,

   192             const TDesC8& aMessageParameters);

   193 

   194     private:

   195             

   196         /*

   197          * For checking if SNAP is still in use.

   198          *

   199          * @since S60 3.2

   200          * @param aServiceId service id

   201          */

   202         void SnapCheckL( TUint aServiceId ) const;

   203         

   204         /*

   205          * Exits GS application if needed

   206          *

   207          * @since S60 3.2

   208          */

   209         TBool ExitGSIfParentL();

   210             

   211     private: // data

   212                        

   213         /** 

   214          * For CSC Application startup parameter handling

   215          * Own.

   216          */

   217         CCSCEngStartupHandler* iStartupHandler;

   218     

   219         /** 

   220          * For CSC Application service handling

   221          * Own.

   222          */

   223         CCSCEngServiceHandler* iServiceHandler;

   224         

   225         /** 

   226          * For CSC Application branding handling

   227          * Own.

   228          */

   229         CCSCEngBrandingHandler* iBrandingHandler;

   230         

   231         /** 

   232          * For CSC Application CCH handling

   233          * Own.

   234          */

   235         CCSCEngCCHHandler* iCCHHandler;

   236         

   237         /** 

   238          * For CSC Application RConnection monitoring

   239          * Own.

   240          */

   241         CCSCEngConnectionHandler* iConnectionHandler;

   242                     

   243         /**

   244          * Pointer to CCSCServiceView

   245          * Not own.

   246          */

   247         CCSCServiceView* iServiceView;

   248         

   249         /**

   250          * Service which is monitored when disabling and removing service

   251          */

   252         TUint iMonitoredService;

   253 

   254 #ifdef _DEBUG

   255     friend class UT_CSC;

   256 #endif

   257              

   258     };

   259 

   260 #endif // C_CSCAPPUI_H