williamr@4: /*
williamr@4: * Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
williamr@4: * All rights reserved.
williamr@4: * This component and the accompanying materials are made available
williamr@4: * under the terms of "Eclipse Public License v1.0"
williamr@4: * which accompanies this distribution, and is available
williamr@4: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4: *
williamr@4: * Initial Contributors:
williamr@4: * Nokia Corporation - initial contribution.
williamr@4: *
williamr@4: * Contributors:
williamr@4: *
williamr@4: * Description: 
williamr@4: *
williamr@4: */
williamr@4: 
williamr@4: #ifndef __AKNNOTIFY_H__
williamr@4: #define __AKNNOTIFY_H__
williamr@4: 
williamr@4: // INCLUDES
williamr@4: #include <e32base.h>
williamr@4: 
williamr@4: // FORWARD DECLARATIONS 
williamr@4: class CAknSDData;
williamr@4: 
williamr@4: // CLASS DECLARATION
williamr@4: class RNotifier2 : public RNotifier
williamr@4:     {
williamr@4: public:
williamr@4:     TInt Connect();
williamr@4:     };
williamr@4:     
williamr@4: /**
williamr@4: *  Base class for handling @c RNotifier.
williamr@4: *
williamr@4: *  @since S60 0.9
williamr@4: */
williamr@4: NONSHARABLE_CLASS(CAknNotifyBase) : public CBase
williamr@4:     {
williamr@4: public:
williamr@4:     /**
williamr@4:     * Destructor.
williamr@4:     */
williamr@4:     IMPORT_C ~CAknNotifyBase();
williamr@4: 
williamr@4:     /**
williamr@4:      * @since S60 3.1
williamr@4:      * Sets additional information to be sent to secondary display.
williamr@4:      * Takes ownership of object.
williamr@4:      * Must be called before sending data to notifier to have effect.
williamr@4:      * @internal to S60
williamr@4:      *
williamr@4:      * @aparam aData data to be sent to cover UI
williamr@4:      */
williamr@4:     IMPORT_C void SetSecondaryDisplayData(CAknSDData* aData);
williamr@4: 
williamr@4: protected:
williamr@4:     /**
williamr@4:     * C++ constructor.
williamr@4:     * @param aUid The UID identifying the plug-in notifier.
williamr@4:     */
williamr@4:     CAknNotifyBase(TUid aUid);
williamr@4:     
williamr@4:     /**
williamr@4:     * 2nd phase constructor.
williamr@4:     * Connects to the notifier server.
williamr@4:     */
williamr@4:     void ConstructL();
williamr@4:     
williamr@4:     /**
williamr@4:     * Starts or updates the notifier.
williamr@4:     * @param aBuffer Data that can be passed to notifier.
williamr@4:     * @param aResponse Data that can be returned by notifier.
williamr@4:     */
williamr@4:     void StartOrUpdateL(const TDesC8& aBuffer, TDes8& aResponse);
williamr@4:     
williamr@4:     /**
williamr@4:     * Starts the notifier.
williamr@4:     * @param aStatus The request status.
williamr@4:     * @param aBuffer Data that can be passed to the notifier.
williamr@4:     * @param aResponse Data that can be returned by the notifier.
williamr@4:     */
williamr@4:     void StartOrUpdateAndGetResponseL(
williamr@4:         TRequestStatus& aStatus,
williamr@4:         const TDesC8& aBuffer,
williamr@4:         TDes8& aResponse);
williamr@4:                                                                             
williamr@4:     // We don't give this funtionality out of library at the moment
williamr@4:     // returns instance of secondary display data if set.
williamr@4:     CAknSDData* SecondaryDisplayData();
williamr@4:                                                                           
williamr@4: private:
williamr@4:     IMPORT_C void CAknNotifyBase_Reserved();
williamr@4: 
williamr@4: private:
williamr@4:     TUid iUid;
williamr@4:     TBool iStarted;
williamr@4:     RNotifier2 iNotify;
williamr@4:     CAknSDData* iSecondaryDisplayData;
williamr@4:     };
williamr@4: 
williamr@4: #endif // __AKNNOTIFY_H__