/*

* Copyright (c) 2005-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:

*

*

*/

#ifndef SAPIDATAPLUGIN_H

#define SAPIDATAPLUGIN_H

#include <aicontentmodel.h>

class MAiContentObserver;

class MAiContentItemIterator;

class CSapiData;

class CGulIcon;

/**

 *  @ingroup group_sapidataplugin

 *

 *  Plug-in main class

 *

 *  @since S60 v3.2

 */

	 /**

	 * Plugin's network state.

	 */

	enum TPluginNetworkStatus 

		{

		EUnknown, 

		EOffline,

		EOnline

		};

	/**

	 * Plugin's state.

	 */

	enum TPluginStates

		{

		ENone,

		EResume,

		};

public:

    /**

    * Part of the two phased constuction

    *

    * @param none

    * @return none

    */

    static CSapiDataPlugin* NewL();

    /**

    * Destructor

    *

    * @param none

    * @return none

    */

    ~CSapiDataPlugin();

private:

    /**

    * Constructor

    *

    * @param none

    * @return none

    */

    CSapiDataPlugin();

    /**

    * Part of the two phased construction

    *

    * @param void

    * @return void

    */

    void ConstructL();

    /**

    /**

    /**

    /**

    /**

    /**

     */

     */

    /**

    /**

    * Publishes widget's texts and images

    *

    * @param void

    * @return void

    */

    void PublishL();	

	/**

	* Gets the id of a content  

	*

	* @param aObjectId image or text id

	* @return id of the content

	*/

	TInt GetIdL(TDesC& aObjectId);

    /**

    * Gets the type of a specific content

    *

    * @param aObjectId image or text id

    * @return void

    */

	const TDesC& GetTypeL( TDesC& aObjectId );

    /**

    * RefereshL a specific image of text in the widget

    *

    * @param aContentType content type

    * @param aOperation operation performed

    * @return void

    */

    void RefreshL(TDesC& aContentType, TDesC& aOperation);

    /**

    * Is plugin active to publish the data 

    *

    * @param void 

    * @return boolean (ETrue/EFalse)

    */

    /**

	* Publish a specific text of the widget  

	*

	* @param aObserver observer

	* @param aContentId content model id

	* @param aContentValue content value

	* @return void

	*/

	void PublishTextL(MAiContentObserver* aObserver, 

			TInt& aContentId, TDesC& aContentValue);

	/**

    * Publish a specific image of the widget  

    *

    * @param aObserver observer

    * @param aContentId content model id

    * @param aHandle image handle 

    * @param aMaskHandle handle of the mask image

    * @return void

    */

    void PublishImageL(MAiContentObserver* aObserver, 

            TInt& aContentId, TInt aHandle, TInt aMaskHandle);

    /**

    * Publish a specific image of the widget  

    *

    * @param aObserver observer

    * @param aContentId content model id

    * @param aPath image path / skin id pattern / mif id Pattern 

    * @return void

    */

    void PublishImageL(MAiContentObserver* aObserver,

            TInt aContentId, TDesC& aPath );

    /**

    * Cleans a data from the widget

    *

    * @param aObserver observer

    * @param aContentId content model id

    * @return void

    */

    void Clean(MAiContentObserver* aObserver, 

            TInt& aContentId );

    /**

     * CSapiData getter

     * @return Pointer to CSapiData

     */

	/*

	 * Plugin's network status getter

	 */

    TPluginStates iPluginState;

    };

#endif // SAPIDATAPLUGIN_H