/*

* 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:  Preview provider API

*

*/

#ifndef TSPREVIEWOBSERVER_H

#define TSPREVIEWOBSERVER_H

// INCLUDES

#include <e32base.h>

/**

 * Observer for preview screenshot changes. Client must implement this and 

 * register itself when calling CTsFastSwapPreviewProvider::NewL. Callback

 * methods are called whenever there is a new preview screenshot taken from

 * the applications or when an application is exited.

 *

 * @see CTsFastSwapPreviewProvider

 */

class MTsFastSwapPreviewObserver

    {

public:

    /**

     * Called when application has changed and screenshot has been taken. 

     * New sceenshots will be taken and provided to the client via this 

     * callback every time the application goes to background.

     *

     * @param aWgId Window group id of the application.

     * @param aFbsHandle Handle to screenshot CFbsBitmap.

     */         

    virtual void HandleFswPpApplicationChange( TInt aWgId, TInt aFbsHandle ) = 0;

    /**

     * Called when application has been exited. Client can free the resources

     * related to aWgId (for example a copied bitmap) since the application is

     * no more running.

     *

     * @param aWgId Window group id of the application.

     */         

    virtual void HandleFswPpApplicationUnregistered( TInt aWgId ) = 0;

    /**

     * Called when screenshot for the application needs rotation. Client should

     * rotate bitmap for the given aWgId by 90 degrees, otherwise it will be

     * displayed incorrectly.

     * 

     * @param aWgId Window group id of the application

     * @param aClockwise marks direction of the rotation (ETrue - clockwise, EFalse - counter clockwise)

     */

    virtual void HandleFswPpApplicationBitmapRotation( TInt aWgId, TBool aClockwise ) = 0;

    };

#endif // TSPREVIEWOBSERVER_H

// End of file