1 /*

     2 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Customization interface for plugins to use.

    15 *

    16 */

    17 

    18 

    19 #ifndef TELBUBBLEEXTENSIONOBSERVER_H

    20 #define TELBUBBLEEXTENSIONOBSERVER_H

    21 

    22 #include <e32base.h>

    23 

    24 class CTelBubbleCustomElement;

    25 

    26 class MTelBubbleExtensionObserver

    27     {

    28 public:

    29     /**

    30      * Call this before attach, detach and replace operations,

    31      * when doing multipe changes outside BubbleUpdating() method. 

    32      * UI is not redrawn until calling EndChanges() is called. 

    33      */

    34     virtual void StartChanges() = 0;

    35     

    36     /**

    37      * Call this when all changes have been done and UI can be

    38      * redrawn.

    39      */

    40     virtual void EndChanges() = 0;

    41     

    42     /**

    43      * Attaches element to bubble. Causes redraw.

    44      * @param aBubbleId Bubble id

    45      * @param aElement Element to be attached, ownership is not transferred

    46      */

    47     virtual void AttachElement( 

    48             TInt aBubbleId, 

    49             CTelBubbleCustomElement* aElement ) = 0;

    50     

    51     /**

    52      * Replaces element in bubble. Causes redraw.

    53      * @param aBubbleId Bubble id

    54      * @param aOld Element to be detached, ownership is not transferred

    55      * @param aNew Element to be attached, ownership is not transferred

    56      */

    57     virtual void ReplaceElement( 

    58             TInt aBubbleId, 

    59             CTelBubbleCustomElement* aOld, 

    60             CTelBubbleCustomElement* aNew ) = 0;

    61     

    62     /**

    63      * Detaches element in bubble. Causes redraw.

    64      * @param aBubbleId Bubble id

    65      * @param aElement Element to be detached, ownership is not transferred

    66      */

    67     virtual void DetachElement( 

    68             TInt aBubbleId, 

    69             CTelBubbleCustomElement* aElement ) = 0;

    70     

    71     };

    72 

    73 #endif // TELBUBBLEEXTENSIONOBSERVER_H

    74 

    75 // end of file