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