/*
* Copyright (c) 2009-2010 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:  External rendering plugin adapter
*
*/

#ifndef XNEXTRENDERINGPLUGINADAPTER_H
#define XNEXTRENDERINGPLUGINADAPTER_H

// System includes
#include <e32base.h>
#include <ecom/ecom.h>
#include <coecntrl.h>

// User includes

class MXnExtEventHandler;

/**
 *  Base class for the external rendering plug-ins. Widget developer
 *  can implement own rendering plug-in if stock plug-ins do not
 *  provide sufficient functionality. Baddly written plug-in can 
 *  ruin the Homescreen performance as it runs in the Homescreen
 *  process. Power save mode must be obeyed in order to maximize
 *  the standby times of the device.
 *
 *
 *  @code
 *
 *  @endcode
 *
 *  @lib extrenderingplugin.lib
 *  @since S60 v5.2
 */
class CXnExtRenderingPluginAdapter : public CCoeControl
    {
public: // Constructor and destructor
    /**
     * Two-phased constructor.
     *
     * @since Series 60 5.2
     */
    IMPORT_C static CXnExtRenderingPluginAdapter* NewL( TUid aImplUid );

    /**
     * Destructor.
     *
     * @since Series 60 5.2
     */
    IMPORT_C virtual ~CXnExtRenderingPluginAdapter();  

public: // New functions,

    /**
     * Returns the ECOM implementation uid.
     *
     * @since Series 60 5.2
     */
    IMPORT_C TUid ImplUid() const;

    /**
     * Is called when Homescreen enters power save mode.
     * In power save mode all the timers, outstanding requests and animations
     * must be cancelled in order to save battery.
     *
     * @since Series 60 5.2
     */
    IMPORT_C virtual void EnterPowerSaveModeL();

    /**
     * Is called when Homescreen exists power save mode.
     *
     * @since Series 60 5.2
     */    
    IMPORT_C virtual void ExitPowerSaveModeL();

    /**
     * Informs skin change. If plug-in is responsible of loading skin
     * graphics, all the graphics must be reloaded.
     *
     * @since Series 60 5.2
     */    
    IMPORT_C virtual void SkinChanged();
    
    /**
     * Informs that plug-in element has gained a focus and highlight must be
     * drawn if appropriate.
     *
     * @since Series 60 5.2
     * @param aDrawNow whether plug-in should draw itself.
     */
    IMPORT_C virtual void FocusChanged( TDrawNow aDrawNow );
    
    /**
     * Informs that plug-in element size has changed. Size can change if the
     * plug-in element is declared relatively to parent element.
     *
     * @since Series 60 5.2
     */
    IMPORT_C virtual void SizeChanged();
    
    /**
     * Sets the external event handler interface.
     *
     * @since Series 60 5.2
     * @param aEventHandler Event handler interface.
     */
    IMPORT_C virtual void SetEventHandler( MXnExtEventHandler* aEventHandler );
    
    /**
     * Routes the data stream for the external rendering plugin.
     *
     * @since Series 60 5.2
     * @param aData Data stream.
     * @param aType Type of the stream.
     * @param aIndex Index of the data.
     */
    IMPORT_C virtual void SetDataL( const TDesC8& aData, const TDesC& aType, TInt aIndex );

private: // Data

    /**
     * Destruct key
     */
    TUid iDestructKey;
    
    /**
     * Implementation UID
     */
    TUid iImplUid;
    };


#endif // XNEXTRENDERINGPLUGINADAPTER_H

// End of file