homescreenapp/hsapplicationlauncher/inc/hsapplicationlauncher.h
author hgs
Mon, 13 Sep 2010 13:03:23 +0300
changeset 86 e4f038c420f7
parent 63 52b0f64eeb51
permissions -rw-r--r--
201036
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
63
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 1020 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description: application class.
hgs
parents:
diff changeset
    15
*/
hgs
parents:
diff changeset
    16
hgs
parents:
diff changeset
    17
#ifndef __HS_LAUNCH_
hgs
parents:
diff changeset
    18
#define __HS_LAUNCH_
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#include <e32base.h>
hgs
parents:
diff changeset
    21
#include <centralrepository.h>
hgs
parents:
diff changeset
    22
#include <cenrepnotifyhandler.h>
hgs
parents:
diff changeset
    23
#include "hsprocessmonitor.h"
hgs
parents:
diff changeset
    24
#include "hsshutdownmonitor.h"
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
class t_hsapplicationlauncher;
hgs
parents:
diff changeset
    27
hgs
parents:
diff changeset
    28
/**
hgs
parents:
diff changeset
    29
 * CHsLaunch
hgs
parents:
diff changeset
    30
 * 
hgs
parents:
diff changeset
    31
 * application class.
hgs
parents:
diff changeset
    32
 * 
hgs
parents:
diff changeset
    33
 * @since S60 5.2  
hgs
parents:
diff changeset
    34
 */
hgs
parents:
diff changeset
    35
class CHsLaunch : public CActive,
hgs
parents:
diff changeset
    36
                         MCenRepNotifyHandlerCallback,
hgs
parents:
diff changeset
    37
                         MHsProcessMonitorObserver,
hgs
parents:
diff changeset
    38
                         MHsShutdownMonitorObserver
hgs
parents:
diff changeset
    39
    {
hgs
parents:
diff changeset
    40
    public:
hgs
parents:
diff changeset
    41
        /**
hgs
parents:
diff changeset
    42
         * Create new launcher
hgs
parents:
diff changeset
    43
         *
hgs
parents:
diff changeset
    44
         * @since S60 5.2     
hgs
parents:
diff changeset
    45
         */    
hgs
parents:
diff changeset
    46
        static CHsLaunch* NewL();
hgs
parents:
diff changeset
    47
        
hgs
parents:
diff changeset
    48
        /**
hgs
parents:
diff changeset
    49
         * Destructor.
hgs
parents:
diff changeset
    50
         *
hgs
parents:
diff changeset
    51
         * @since S60 5.2     
hgs
parents:
diff changeset
    52
         */
hgs
parents:
diff changeset
    53
        virtual ~CHsLaunch();
hgs
parents:
diff changeset
    54
hgs
parents:
diff changeset
    55
        /**
hgs
parents:
diff changeset
    56
         * Set active object to be ran
hgs
parents:
diff changeset
    57
         * 
hgs
parents:
diff changeset
    58
         * @since S60 5.2
hgs
parents:
diff changeset
    59
         */        
hgs
parents:
diff changeset
    60
        void Activate();        
hgs
parents:
diff changeset
    61
hgs
parents:
diff changeset
    62
        /**
hgs
parents:
diff changeset
    63
         * Get application return value
hgs
parents:
diff changeset
    64
         * 
hgs
parents:
diff changeset
    65
         * @return TInt     Application return value
hgs
parents:
diff changeset
    66
         * @since S60 5.2
hgs
parents:
diff changeset
    67
         */        
hgs
parents:
diff changeset
    68
        TInt ApplicationReturnValue();      
hgs
parents:
diff changeset
    69
        
hgs
parents:
diff changeset
    70
    protected:
hgs
parents:
diff changeset
    71
        /**
hgs
parents:
diff changeset
    72
         * C++ constructor.
hgs
parents:
diff changeset
    73
         *
hgs
parents:
diff changeset
    74
         * @since S60 5.2      
hgs
parents:
diff changeset
    75
         */        
hgs
parents:
diff changeset
    76
        CHsLaunch();    
hgs
parents:
diff changeset
    77
        
hgs
parents:
diff changeset
    78
        /**
hgs
parents:
diff changeset
    79
         * Symbian 2nd phase constructor
hgs
parents:
diff changeset
    80
         * 
hgs
parents:
diff changeset
    81
         * @since S60 5.2
hgs
parents:
diff changeset
    82
         */        
hgs
parents:
diff changeset
    83
        void ConstructL();
hgs
parents:
diff changeset
    84
    
hgs
parents:
diff changeset
    85
    private: // From CActive.
hgs
parents:
diff changeset
    86
        /**
hgs
parents:
diff changeset
    87
         * From CActive
hgs
parents:
diff changeset
    88
         */        
hgs
parents:
diff changeset
    89
        void RunL();
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
        /**
hgs
parents:
diff changeset
    92
         * From CActive
hgs
parents:
diff changeset
    93
         * 
hgs
parents:
diff changeset
    94
         * @since S60 5.2
hgs
parents:
diff changeset
    95
         */        
hgs
parents:
diff changeset
    96
        void DoCancel(); 
hgs
parents:
diff changeset
    97
hgs
parents:
diff changeset
    98
        /**
hgs
parents:
diff changeset
    99
         * From CActive
hgs
parents:
diff changeset
   100
         * 
hgs
parents:
diff changeset
   101
         * @since S60 5.2
hgs
parents:
diff changeset
   102
         */        
hgs
parents:
diff changeset
   103
        TInt RunError( TInt aError );
hgs
parents:
diff changeset
   104
hgs
parents:
diff changeset
   105
    private: // From MCenRepNotifyHandlerCallback
hgs
parents:
diff changeset
   106
        /**
hgs
parents:
diff changeset
   107
         * From MCenRepNotifyHandlerCallback
hgs
parents:
diff changeset
   108
         */
hgs
parents:
diff changeset
   109
        void HandleNotifyInt(TUint32 aId, TInt aNewValue);
hgs
parents:
diff changeset
   110
        
hgs
parents:
diff changeset
   111
    private: // From MHsProcessMonitorObserver
hgs
parents:
diff changeset
   112
        /**
hgs
parents:
diff changeset
   113
         * From MHsProcessMonitorObserver
hgs
parents:
diff changeset
   114
         */
hgs
parents:
diff changeset
   115
        void ProcessEnded( const TExitType& aExitType,
hgs
parents:
diff changeset
   116
                           const TInt aExitReason,
hgs
parents:
diff changeset
   117
                           const TExitCategoryName& aExitCategory );
hgs
parents:
diff changeset
   118
hgs
parents:
diff changeset
   119
        /**
hgs
parents:
diff changeset
   120
         * From MHsProcessMonitorObserver
hgs
parents:
diff changeset
   121
         */
hgs
parents:
diff changeset
   122
        void ProcessMonitoringError( TInt aError );
hgs
parents:
diff changeset
   123
hgs
parents:
diff changeset
   124
    private: // From MHsShutdownMonitorObserver
hgs
parents:
diff changeset
   125
        /**
hgs
parents:
diff changeset
   126
         * From MHsShutdownMonitorObserver
hgs
parents:
diff changeset
   127
         */
hgs
parents:
diff changeset
   128
        void SystemShutdownEvent();
hgs
parents:
diff changeset
   129
hgs
parents:
diff changeset
   130
    private:
hgs
parents:
diff changeset
   131
        /**
hgs
parents:
diff changeset
   132
         * Initialize process monitor
hgs
parents:
diff changeset
   133
         * 
hgs
parents:
diff changeset
   134
         * @param aProcessId    Id of process to monitor 
hgs
parents:
diff changeset
   135
         */
hgs
parents:
diff changeset
   136
        void InitProcessMonitorL( const TInt aProcessId );
hgs
parents:
diff changeset
   137
        
hgs
parents:
diff changeset
   138
        /**
hgs
parents:
diff changeset
   139
         * Shut down application 
hgs
parents:
diff changeset
   140
         * 
hgs
parents:
diff changeset
   141
         * @param aApplicationReturnValue   Application return value.
hgs
parents:
diff changeset
   142
         */
hgs
parents:
diff changeset
   143
        void ShutdownApp( const TInt aApplicationReturnValue );         
hgs
parents:
diff changeset
   144
        
hgs
parents:
diff changeset
   145
        /**
hgs
parents:
diff changeset
   146
         * Starts the home screen application.
hgs
parents:
diff changeset
   147
         */
hgs
parents:
diff changeset
   148
        void StartHomeScreen();
hgs
parents:
diff changeset
   149
        
hgs
parents:
diff changeset
   150
        /**
hgs
parents:
diff changeset
   151
         * Checks if the language is selected.
hgs
parents:
diff changeset
   152
         */
hgs
parents:
diff changeset
   153
        TBool IsLanguageSelectedL();
hgs
parents:
diff changeset
   154
        
hgs
parents:
diff changeset
   155
        /**
hgs
parents:
diff changeset
   156
         * Starts listening the repository notifications for
hgs
parents:
diff changeset
   157
         * language selection.
hgs
parents:
diff changeset
   158
         */
hgs
parents:
diff changeset
   159
        void StartListeningLanguageSelectionL();
hgs
parents:
diff changeset
   160
        
hgs
parents:
diff changeset
   161
        /**
hgs
parents:
diff changeset
   162
         * Stops listening the repository notifications for
hgs
parents:
diff changeset
   163
         * language selection.
hgs
parents:
diff changeset
   164
         */
hgs
parents:
diff changeset
   165
        void StopListeningLanguageSelection();
hgs
parents:
diff changeset
   166
        
hgs
parents:
diff changeset
   167
    private: // data.
hgs
parents:
diff changeset
   168
        // Process monitor. Owned.
hgs
parents:
diff changeset
   169
        CHsProcessMonitor* iProcessMonitor;
hgs
parents:
diff changeset
   170
        
hgs
parents:
diff changeset
   171
        // Shutdown monitor. Owned.
hgs
parents:
diff changeset
   172
        CHsShutdownMonitor* iShutdownMonitor;
hgs
parents:
diff changeset
   173
        
hgs
parents:
diff changeset
   174
        // Repository.
hgs
parents:
diff changeset
   175
        CRepository *iRepository;
hgs
parents:
diff changeset
   176
hgs
parents:
diff changeset
   177
        // Repository notify handler.
hgs
parents:
diff changeset
   178
        CCenRepNotifyHandler* iCenRepNotifyHandler;
hgs
parents:
diff changeset
   179
        
hgs
parents:
diff changeset
   180
        // Application return value
hgs
parents:
diff changeset
   181
        TInt iApplicationReturnValue;
hgs
parents:
diff changeset
   182
hgs
parents:
diff changeset
   183
        friend class t_hsapplicationlauncher;
hgs
parents:
diff changeset
   184
    };
hgs
parents:
diff changeset
   185
hgs
parents:
diff changeset
   186
#endif // __HS_LAUNCH_