/*

* 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:    

*

*/

#ifndef IAUPDATEBGSOFTNOTIFICATION_H

#define IAUPDATEBGSOFTNOTIFICATION_H

// INCLUDES

#include <e32base.h>

#include <AknDynamicSoftNotifier.h>

#include "iaupdatebgcheckermode.h"

// FORWARD DECLARATION

class TAknDynamicSoftNotificationParams;

class CIAUpdateBGInternalFileHandler;

class MIAUpdateBGSoftNotificationCallBack

    {

    public:

        virtual void SoftNotificationCallBack( TBool aIsAccepted ) = 0;

        virtual TIAUpdateBGMode CurrentMode() = 0;

    };

// CLASS DECLARATION

/**

 *  Controls the native soft notifications.

 *  This class delegates method calls to AvKon soft notification.

 *

 *  @since 3.2

 */

class CIAUpdateBGSoftNotification : public CBase, public MAknDynamicSoftNoteObserver

    {

    public:  // Constructors and destructor

        /**

         * Static constructor

         */

        static CIAUpdateBGSoftNotification* NewL( MIAUpdateBGSoftNotificationCallBack* aCallback, CIAUpdateBGInternalFileHandler* aInternalFile );

        /**

         * Destructor.

         */

        virtual ~CIAUpdateBGSoftNotification();

    public: // From MAknDynamicSoftNotifierObserver

        /**

         * Dynamic soft notification was accepted by user.

         *

         * @param aNoteId Identification of notification.

         */

        void NotificationAccepted( TInt aIdentifier );

        /**

         * Dynamic soft notification was canceled by user.

         *

         * @param aNoteId Identification of notification.

         */

        void NotificationCanceled( TInt aIdentifier );

    public: // New functions

        void StartObservingIfNeededL();

        /**

         * Add a custom soft notification. If a custom soft notification with

         * exactly the same parameters already exists,

         * its count is increased by aCount.

         *

         * @param aNotificationId identifier for this notification

         * @param aCount addition count

         */

        void ShowSoftNotificationL();

        /**

         * Cancels custom soft notification.

         *

         * @param aNotificationId identifier for this notification

         */

        void RemoveSoftNotificationL( TInt aNotifierID );

        /**

         * Set a text for a soft notification.

         *

         * @param aSingularText singular text for soft notification

         * @param aPluralText plural text for soft notification

         */

        void SetTextL( const TDesC& aText, const TDesC& aGroupText );

        /**

         * Set labels for soft notification's softkeys.

         *

         * @param aSoftkey1Label Label for the softkey 1

         * @param aSoftkey2Label Label for the softkey 2

         */

        void SetSoftkeyLabelsL( const TDesC& aSoftkey1Label,

            const TDesC& aSoftkey2Label );

        /**

         * Set an image for a soft notification.

         *

         * @param aImage image for soft notification

         */

        void SetImageL( const TDesC8& aImage );

        /**

         * Returns the notification id.

         *

         * @return notification id

         */

        TInt Id();

    private:  // Constructors

        /**

         * C++ constructor.

         *

         * @param aAppId View activation application id.

         * @param aNotificationId Notification id.

         * @param aEventSource Event source used for posting events from

         *        native to Java side.

         */

        CIAUpdateBGSoftNotification( MIAUpdateBGSoftNotificationCallBack* aCallback, CIAUpdateBGInternalFileHandler* aInternalFile );

        /**

         * 2nd phase constructor.

         */

        void ConstructL();

    private:  // New methods

        /**

         * Set assigned member data to custom notification parameters

         *

         * @param aParam custom soft notification params to fill

         */

        void FillNotificationParams( TAknDynamicSoftNotificationParams& aParam );

    private:  // Data

        /// Own. AvKon custom soft notifier

        CAknDynamicSoftNotifier* iNotifier;

        /// View activation application id

        TUid iAppId;

        /// Notification Id

        TInt iNotificationId;

        /// Own. Softkey 1 label

        HBufC* iSoftkey1;

        /// Own. Softkey 2 label

        HBufC* iSoftkey2;

        /// Own. Note label when single dialog is shown

        HBufC* iLabel;

        /// Own. Note label when notifications are groupped

        HBufC* iGroupLabel;

        /// Own. Image data byte array

        HBufC8* iImageData;

        MIAUpdateBGSoftNotificationCallBack* iCallback;

        CIAUpdateBGInternalFileHandler* iInternalFile; //not owned

    };

#endif // IAUPDATEBGSOFTNOTIFICATION_H