/*

* Copyright (c) 2008 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:  Incoming Call Handler.

*

*/

#ifndef C_EVTCALLHANDLER_H

#define C_EVTCALLHANDLER_H

// System Includes

#include <e32base.h>

#include <etel3rdparty.h>

//Forward Declaration

// Class Definition

/**

 *  Interface class to observe for an incoming call.

 *

 *  @lib 

 *  @since S60 v9.1

 */

class MEvtCallObserver

    {

public:	    

    /**

     * This will notify when there is an incoming call.            

     */

    virtual void HandleIncomingCallL( )=0;

    };

/**

 *  Adapter class to observe for an incoming Call.

 *  This class listens for an incoming call and notifies

 *  the observer(MEvtCallObserver).

 *

 *  @lib 

 *  @since S60 v9.1

 */

NONSHARABLE_CLASS( CEvtCallHandler ): public CActive

{

public:

    /**

     * Constructs a new instance of Call Handler.

     *

     * @return The new instance of Call Handler object.

     * @leave System wide error code if the object creation fails.         

     */

    static CEvtCallHandler* NewL( MEvtCallObserver& aObserver );

    /**

     * Constructs a new instance of Call Handler.

     * Leaves the created instance on the cleanup stack.

     *

     * @return The new instance of Call Handler object.

     * @leave System wide error code if the object creation fails.         

     */

    static CEvtCallHandler* NewLC( MEvtCallObserver& aObserver );  

    /**

    * Destructor.

    */

    virtual ~CEvtCallHandler();

public:  // Public Functions	

	    /**

	     * Starts listening for the incoming calls.

	     */

	    void StartListening();

        /**

        * Check if there is any outstanding call.

        * @param TBool Returns ETrue if a call is active.

        */

        TBool IsCallActive( );

        /**

        * Check if there is any incoming call.

        * @param TBool Returns ETrue if there is an incoming call.

        */

        TBool IsCallIncoming( );

private: 

    /**

     * From CActive

     */

    void RunL();

    /**

     * From CActive

     */

    TInt RunError(TInt anError);

    /**

     * From CActive

     */

    void DoCancel();

    /**

     * Default C++ Constructor.

     */

	CEvtCallHandler( MEvtCallObserver& aObserver );

    /**

     * Second phase of the two phase constructor.

     */

    void ConstructL();

private: // data

	/**

	 * Incoming Call Observer.

	 */

	 MEvtCallObserver& iObserver;

	/**

	 * CTelephony handle.

	 * Own

	 */

     CTelephony* iTelephony;

	/**

	 * Call status

	 */

     CTelephony::TCallStatusV1 iCallStatus;

	/**

	 * Package for Call status

	 */

     CTelephony::TCallStatusV1Pckg iCallStatusPkg;

};

#endif C_EVTCALLHANDLER_H