1 /*

     2 * Copyright (c) 2005 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: 

    15 *     Describes all possible System events.

    16 *

    17 */

    18 

    19 

    20 #ifndef __MPHONESYSTEMEVENTS_H

    21 #define __MPHONESYSTEMEVENTS_H

    22 

    23 //  INCLUDES

    24 #include <aknappui.h>

    25 

    26 // CLASS DECLARATION

    27 

    28 /**

    29 *  All possible system events

    30 */

    31 class MPhoneSystemEvents

    32     {

    33 

    34     public:

    35 

    36         /**

    37         * Destructor

    38         */

    39         virtual ~MPhoneSystemEvents(){};

    40 

    41         /**

    42         * From CAknAppUi, initialise a menupane (dynamic).

    43         *

    44         * @param aResourceId It is the resource id for the pane.

    45         * @param aMenuPane It is the menu pane corresponding to the resource.

    46         */

    47         virtual void DynInitMenuPaneL( 

    48             TInt aResourceId, 

    49             CEikMenuPane* aMenuPane ) = 0;

    50 

    51         /**

    52         * From CAknAppUi, initialise a menubar (dynamic).

    53         *

    54         * @param aResourceId It is the resource id for the bar.

    55         * @param aMenuBar It is the menu bar corresponding to the resource.

    56         */

    57         virtual void DynInitMenuBarL( 

    58             TInt aResourceId, 

    59             CEikMenuBar* aMenuBar ) = 0;

    60 

    61         /**

    62         * From CEikAppUi. For Idle indicator

    63         */

    64         virtual void HandleSystemEventL( const TWsEvent& aEvent ) = 0;

    65 

    66         /**

    67         * From CAknAppUi, indicates when app ui is on the foreground.

    68         * @param aForeground It is true if app is on the foreground.

    69         */

    70         virtual void HandleForegroundEventL( TBool aForeground ) = 0;

    71 

    72         /**

    73         * Indicates when the Phone app is in the foreground.

    74         */

    75         virtual void HandlePhoneForegroundEventL() = 0;

    76         

    77         /**

    78         * Indicates when the Phone app is is losing focus.

    79         */

    80         virtual void HandlePhoneFocusLostEventL() = 0;

    81         

    82         /**

    83         * Indicates when the Idle app is in the foreground.

    84         */

    85         virtual void HandleIdleForegroundEventL() = 0;

    86 

    87         /**

    88         * Indicates when the keylock events

    89         */

    90         virtual void HandleKeyLockEnabled( TBool aKeylockEnabled ) = 0;

    91         

    92         /**

    93         * Handle environment changes.

    94         * @param aChanges environment changes which may be reported by

    95         *  a change notifier through the RChangeNotifier interface.

    96         */

    97         virtual void HandleEnvironmentChangeL( const TInt aChanges ) = 0;

    98 

    99         /**

   100         * Handles startup of the phone application 

   101         */

   102         virtual void HandlePhoneStartupL() = 0;

   103 

   104         /**

   105         * This function is called when there is property value change.

   106         * @param aCategory Category of the property

   107         * @param aKey Property key that is changed

   108         * @param aValue New property value

   109         */

   110         virtual void HandlePropertyChangedL( 

   111             const TUid& aCategory,

   112             const TUint aKey,

   113             const TInt aValue ) = 0;

   114 

   115         /**

   116         * Handle the change of the setting from Central Repository

   117         * @param aUid identifing the central repository UID.

   118         * @param aId central repository ID.

   119         */

   120         virtual void HandleCenRepChangeL( 

   121             const TUid& aUid,

   122             const TUint aId ) = 0;

   123     };

   124 

   125 #endif      // __MPHONESYSTEMEVENTS_H   

   126             

   127 // End of File