/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  Provides emergency call support for keyguard/devicelock
 *
*/


#ifndef __LOCKAPPSTATEDETECTOR_H__
#define __LOCKAPPSTATEDETECTOR_H__

// INCLUDES
#include "lockappstateobserver.h"
#include <AknEcs.h> // MAknEcsObserver and CAknEcsDetector

// FORWARD DECLARATIONS
class CLockAppEcsNote;

/**
 *  CLockAppEcsDetector class owns emergency note and emergency detector.
 *  Taps directly to AppUi windowserver event source for receiving key events.
 *  If user presses emergency numbers defined in SIM, emergency note is shown.
 *  Only works when keyguard or devicelock is activated.
 *
 *  @lib    lockapp
 *  @since  5.0
 *  @author Joona Petrell
 *  @author Tamas Koteles
 */
class CLockAppEcsDetector : public CBase, public MLockAppStateObserver, public MAknEcsObserver
    {
    public:

        /**
         * Two-phased constructor.
         */
        static CLockAppEcsDetector* NewL( );

        /**
         * Destructor
         */
        ~CLockAppEcsDetector( );

    private:

        /**
         * C++ default constructor.
         */
        CLockAppEcsDetector( );

        /**
         * Second constructor that can fail (leave).
         */
        void ConstructL( );

    public:

        /**
         * From @c CLockAppStateObserver. Method handles the lock state changes.
         *
         * @param aLockStatus The new lock state
         */
        virtual void HandleLockStatusChangedL( TLockStatus aLockStatus );

    private:

        /**
         * From @c MAknEcsObserver. Handles changes in emergency call detector.
         * @param aEcsDetector a pointer to ecsdetector component
         * @param aState the new emergency detector state.
         */
        void HandleEcsEvent( CAknEcsDetector* aEcsDetector, CAknEcsDetector::TState aState );

    public:

        /**
         * Emergency note is visible.
         *
         * @return true if emergency note is on the screen.
         */
        TBool EcsNoteOnScreen( ) const;

        /**
         * Internal Method only used for testing since emergency number
         * detection does not work in emulator.
         *
         * @return KErrNone if there were no problems
         */
        TInt TestEcsNote( );

    private:

        /**
         * Receives emergency number key events and handles emergency dialing.
         * Own.
         */
        CAknEcsDetector* iEcsDetector;

        /**
         * Emergency note to be shown when user has dialed emergency number.
         * Own.
         */
        CLockAppEcsNote* iEcsNote;

    };

#endif // __LOCKAPPSTATEDETECTOR_H__
// End of File