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 __MPHONESYSTEMEVENTHANDLER_H

    21 #define __MPHONESYSTEMEVENTHANDLER_H

    22 

    23 //  INCLUDES

    24 #include <aknappui.h>

    25 

    26 // CLASS DECLARATION

    27 

    28 /**

    29 *  All possible system events

    30 */

    31 class MPhoneSystemEventHandler

    32     {

    33     public:

    34 

    35         /**

    36         * Destructor

    37         */

    38         virtual ~MPhoneSystemEventHandler(){};

    39 

    40         /**

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

    42         *

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

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

    45         */

    46         virtual void DynInitMenuPaneL( 

    47             TInt aResourceId, 

    48             CEikMenuPane* aMenuPane ) = 0;

    49 

    50         /**

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

    52         *

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

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

    55         */

    56         virtual void DynInitMenuBarL( 

    57             TInt aResourceId, 

    58             CEikMenuBar* aMenuBar ) = 0;

    59 

    60         /**

    61         * From CEikAppUi. For Idle indicator

    62         */

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

    64 

    65         /**

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

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

    68         */

    69         virtual void HandleForegroundEventL( TBool aForeground ) = 0;

    70 

    71         /**

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

    73         */

    74         virtual void HandlePhoneForegroundEventL() = 0;

    75 

    76         /**

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

    78         */

    79         virtual void HandleIdleForegroundEventL() = 0;

    80 

    81         /**

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

    83         */

    84         virtual void HandlePhoneFocusLostEventL() = 0;

    85 

    86         /**

    87         * Handle environment changes.

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

    89         *  a change notifier through the RChangeNotifier interface.

    90         */

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

    92 

    93         /**

    94         * Handles startup of the phone application 

    95         */

    96         virtual void HandlePhoneStartupL() = 0;

    97 

    98         /**

    99         * Indicates when the keylock events

   100         */

   101         virtual void HandleKeyLockEnabled( TBool aKeylockEnabled ) = 0;

   102         

   103     };

   104 

   105 #endif      // __MPHONESYSTEMEVENTHANDLER_H   

   106             

   107 // End of File