/*

* Copyright (c) 2008-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:  Manages MCP plugins, and content publishing.

*

*/

#ifndef M_MCPPLUGINOBSERVER_H

#define M_MCPPLUGINOBSERVER_H

class CLiwDefaultMap;

class CMCPPlugin;

/**

 * Music Widget Image Destinations.

 * 9.1 Music Widget has two panels, The left panel contains an image:

 * TMCPImageDestination:EMWImage1, the right panel contains three text

 * rows: TMCPTextDestination:EMWText1, TMCPTextDestination:EMWText2, 

 * TMCPTextDestination:EMWText3. Actions can be installed into this

 * two panels to the triggers: TMCPTriggerDestination:EMWTrigger1, 

 * TMCPTriggerDestination:EMWTrigger2.

 */

enum TMCPImageDestination

    {

     EMusicWidgetImage1 = 1000//do not change

    };

/**

 * Music Widget Text Destinations.

 * 9.1 Music Widget has two panels, The left panel contains an image:

 * TMCPImageDestination:EMWImage1, the right panel contains three text

 * rows: TMCPTextDestination:EMWText1, TMCPTextDestination:EMWText2, 

 * TMCPTextDestination:EMWText3. Actions can be installed into this

 * two panels to the triggers: TMCPTriggerDestination:EMWTrigger1, 

 * TMCPTriggerDestination:EMWTrigger2.

 */

enum TMCPTextDestination

    {

     EMusicWidgetText1 = 2000//do not change

     ,EMusicWidgetText2

     ,EMusicWidgetText3

    };

/**

 * Music Widget Action Destinations.

 * 9.1 Music Widget has two panels, The left panel contains an image:

 * TMCPImageDestination:EMWImage1, the right panel contains three text

 * rows: TMCPTextDestination:EMWText1, TMCPTextDestination:EMWText2, 

 * TMCPTextDestination:EMWText3. Actions can be installed into this

 * two panels to the triggers: TMCPTriggerDestination:EMWTrigger1, 

 * TMCPTriggerDestination:EMWTrigger2.

 */

enum TMCPTriggerDestination

    {

     EMusicWidgetTrigger1 = 3000//do not change

     ,EMusicWidgetTrigger2

    };

/**

 *  Observer interface, to be implemented by the Music Content Publisher.

 *  This interface is to be used to inform the music harves of changes on the

 *  plugin that need to be propagated to the Music Widget UI. 

 *  @since S60 5.0

 */

class MMCPPluginObserver

    {

public:

    /**

     * Called when an image needs to be updated.

     *

     * @since S60 5.0

     * @param aPlugin Where the mesage is coming from.

     * @param aDestination Where the image is to be placed.

     * @param aImagePath Source path of the Image.

     */

    virtual void PublishImageL(CMCPPlugin* aPlugin,

            TMCPImageDestination aDestination, const TDesC& aImagePath) = 0;

    /**

     * Called when an image needs to be updated.

     *

     * @since S60 5.0

     * @param aPlugin Where the mesage is coming from.

     * @param aDestination Where the image is to be placed.

     * @param aBitmapHandle Bitmap handle to the image.

     */

    virtual void PublishImageL(CMCPPlugin* aPlugin, 

            TMCPImageDestination aDestination, TInt aBitmapHandle) = 0;

    /**

     * Called when a text needs to be updated.

     *

     * @since S60 5.0

     * @param aPlugin Where the mesage is coming from.

     * @param aDestination Where the text is to be placed.

     * @param aText Descriptor containing the text.

     */

    virtual void PublishTextL( CMCPPlugin* aPlugin, 

            TMCPTextDestination aDestination, const TDesC& aText ) = 0;

    /**

     * Called when an action needs to be updated.

     *

     * @since S60 5.0

     * @param aPlugin Where the mesage is coming from.

     * @param aDestination Destination trigger that should launch the action.

     * @param aTrigerMap LIW Map containint the action that can be interpreted

     * by the specified action handler plugin.

     */

    virtual void PublishActionL( CMCPPlugin* aPlugin, 

            TMCPTriggerDestination aDestination, 

            CLiwDefaultMap* aTrigerMap ) = 0;

    /**

     * Called when a plugin becomes active.

     *

     * @since S60 5.0

     * @param aPlugin Where the mesage is coming from.

     */

    virtual void BecameActiveL( CMCPPlugin* aPlugin ) = 0;

    };

#endif /*MCPPLUGINOBSERVER_H*/