1 /*

     2 * ==============================================================================

     3 *  Name        : %name: hgpreviewobserver.h %

     4 *  Part of     : Hg fast swap preview provider plugin

     5 *  Description : Preview provider API

     6 *  Version     : %version: 1 %

     7 *

     8 *  Copyright (c) 2008 Nokia Corporation.

     9 *  This material, including documentation and any related

    10 *  computer programs, is protected by copyright controlled by

    11 *  Nokia Corporation. All rights are reserved. Copying,

    12 *  including reproducing, storing, adapting or translating, any

    13 *  or all of this material requires the prior written consent of

    14 *  Nokia Corporation. This material also contains confidential

    15 *  information which may not be disclosed to others without the

    16 *  prior written consent of Nokia Corporation.

    17 * ==============================================================================

    18 */

    19 

    20 #ifndef HGPREVIEWOBSERVER_H

    21 #define HGPREVIEWOBSERVER_H

    22 

    23 // INCLUDES

    24 #include <e32base.h>

    25 

    26 /**

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

    28  * register itself when calling CHgFastSwapPreviewProvider::NewL. Callback

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

    30  * the applications or when an application is exited.

    31  *

    32  * @see CHgFastSwapPreviewProvider

    33  */

    34 class MHgFastSwapPreviewObserver

    35     {

    36 public:

    37 

    38     /**

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

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

    41      * callback every time the application goes to background.

    42      *

    43      * @param aWgId Window group id of the application.

    44      * @param aFbsHandle Handle to screenshot CFbsBitmap.

    45      */         

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

    47     

    48     /**

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

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

    51      * no more running.

    52      *

    53      * @param aWgId Window group id of the application.

    54      */         

    55     virtual void HandleFswPpApplicationUnregistered( TInt aWgId ) = 0;    

    56     };

    57 

    58 #endif // HGPREVIEWOBSERVER_H

    59 

    60 // End of file