/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "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:
* Ixonos Plc
*
* Description: 
* Forces an	asynchronous callback to be called.
*
*/


#ifndef CALLBACK_H
#define	CALLBACK_H

#include <e32base.h>
#include "callbackmethod.h"

/**
 *  Forces an	asynchronous callback to be called.
 *
 *  @code
 *   ?good_class_usage_example(s)
 *  @endcode
 *
 *  @lib ImageEditorUtils.lib
 *  @since S60 v5.0
 */
class CObCallback : public CActive
{

public:

/** @name Methods:*/
//@{

    /**
     * Two-phased constructor.
     * @param aMethod - observer reference
     * @param ?arg2 ?description
     */
     IMPORT_C static CObCallback * NewL (MObCallbackMethod * aMethod);

    /**
    * Destructor.
    */
    IMPORT_C ~CObCallback();
		
    /**
     * Forces the active scheduler to do callback
     *
     * @since S60 ?S60_version
     * @param aParam - ID for callback, returned to observer
     * @param ?arg2 ?description
     * @return ?description
     */
     IMPORT_C void DoCallback (TInt aParam);

protected:

private:

	CObCallback (MObCallbackMethod * aMethod);
	
	void ConstructL();

// from base class CActive
	
    /**
     * From CActive.
     * See CActive
     *
     * @since S60 ?S60_version
     */
     virtual void RunL();


    /**
     * From CActive.
     * See CActive
     *
     * @since S60 ?S60_version
     */
     virtual void DoCancel();

	/** CompleteRequest
	*
	*	Force RunL
	*
	*	@param -
	*	@return -
	*/
    void CompleteRequest();

private: // data

    /**
     * Observer reference
     */
	  MObCallbackMethod *		iMethod;

    /**
     * Callback ID
     */	
	  TInt                    iParam;
};


#endif // CALLBACK_H