phonebookui/Phonebook2/NamesListExtension/inc/CPbk2EcePresenceEngine.h
changeset 0 e686773b3f54
child 26 0d28c1c5b6dd
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/NamesListExtension/inc/CPbk2EcePresenceEngine.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,158 @@
+/*
+* Copyright (c) 2002-2007 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:  Phonebook 2 Nameslist UI control UI extension.
+*
+*/
+
+
+#ifndef CPbk2EcePresenceEngine_H
+#define CPbk2EcePresenceEngine_H
+
+//  INCLUDES
+#include <e32base.h>
+#include <MPbk2ContactUiControlExtension.h>
+
+#include "CPbk2IconArray.h"
+#include "TPbk2IconId.h"
+#include "CPbk2NlxPresenceIconInfo.h"
+#include "CPbk2NlxPresenceSubscriptionInfo.h"
+#include "MPbk2EcePresenceEngineObserver.h"
+
+#include <mcontactpresenceobs.h>
+#include <mcontactpresenceinfo.h>
+// FORWARD DECLARATIONS
+class CVPbkContactManager;
+class MVPbkContactLink;
+class MContactPresence;
+
+// CLASS DECLARATION
+
+/**
+ * Phonebook 2 ECE Presence Engine.
+ *
+ */
+NONSHARABLE_CLASS(CPbk2EcePresenceEngine) : 
+        public CBase,
+        public MContactPresenceObs
+    {
+    public:  // Constructors and destructor
+        
+        /**
+         * Creates a new instance of this class.
+         *
+         * @param aContactManager       Virtual Phonebook contact manager.
+         * @param aObserver Observer to this engine.
+         * @param aIconSize Required icon size
+         * @return  A new instance of this class.
+         */
+        static CPbk2EcePresenceEngine* NewL(
+            CVPbkContactManager& aContactManager,
+            MPbk2EcePresenceEngineObserver& aObserver,
+            TSize aIconSize );
+        
+        /**
+         * Destructor.
+         */
+        ~CPbk2EcePresenceEngine();
+
+    private: // Construction & destruction
+        CPbk2EcePresenceEngine(
+            CVPbkContactManager& aContactManager,
+            MPbk2EcePresenceEngineObserver& aObserver,
+            TSize aIconSize );
+        void ConstructL();
+        
+    public: // new methods
+
+        /**
+         * Subscribe for presence information of a certain contact.
+         *
+         * @param aLink A contact link.
+         */
+        void SubscribeContactPresenceL( const MVPbkContactLink& aLink );
+
+        /**
+         * Gets the ID of the current presence icon of a contact.
+         * The TBool return value tells whether the icon ID and icon is available.
+         * If the ID is successfully obtained, then CreateIconCopyLC() can be called.
+         *
+         * @param aLink A contact link.
+         *
+         * @return ETrue if the icon ID was available, and vice versa.
+         */
+        TBool GetIconIdForContact( const MVPbkContactLink& aLink, TPbk2IconId& aIconId );
+
+        /**
+         * Creates an icon instance. Call only after a succesfull call to GetIconIdForContactL().
+         *
+         * @exception Panics if called when icon is not available. See GetIconIdForContactL().
+         */
+        CGulIcon* CreateIconCopyLC( const TPbk2IconId& aIconId );
+
+
+    private: // from MContactPresenceObs
+        void ReceiveIconInfoL( 
+            const TDesC8& aPackedLink, 
+            const TDesC8& aBrandId, 
+            const TDesC8& aElementId );
+        void ReceiveIconFileL( 
+            const TDesC8& aBrandId, 
+            const TDesC8& aElementId, 
+            CFbsBitmap* aBrandedBitmap, 
+            CFbsBitmap* aMask );
+        void ReceiveIconInfosL(
+            const TDesC8& aPackedLink,
+            RPointerArray <MContactPresenceInfo>& aInfoArray,
+            TInt aOpId );
+        void PresenceSubscribeError( 
+            const TDesC8& aContactLink,
+            TInt aStatus );        
+        void ErrorOccured( 
+            TInt aOpId, 
+            TInt aStatus );   
+        
+
+    private: // New methods
+
+        void InformObserverOfContactChanges(
+            const TDesC8& aBrandId,
+            const TDesC8& aElementId );
+
+        CPbk2NlxPresenceSubscriptionInfo* FindSubscription( const MVPbkContactLink& aContactLink );
+        CPbk2NlxPresenceIconInfo* FindIconInfo( const TDesC8& aBrandId, const TDesC8& aElementId );
+        CPbk2NlxPresenceIconInfo* FindIconInfo( const TPbk2IconId& aIconId );
+        void CleanUpOldSubscriptionsL();
+        void CleanUpExtraIcons();
+
+        static CFbsBitmap* CloneBitmapL( const CFbsBitmap& aOriginalBitmap );
+
+        static TInt SubscriptionMonitorL(TAny* aPtr);
+        TInt SubscriptionMonitorL();
+        static TSize CalculateListIconSize();
+    private: // Data
+        /// Ref: Virtual Phonebook contact manager
+        CVPbkContactManager& iContactManager;
+
+        MContactPresence* iPresenceClient;
+        RPointerArray<CPbk2NlxPresenceSubscriptionInfo> iSubscriptions; // owns the objects
+        RPointerArray<CPbk2NlxPresenceIconInfo> iIconInfoArray; // owns the objects
+        TInt iNextIconId;
+        MPbk2EcePresenceEngineObserver& iObserver;
+        CIdle* iSubscriptionMonitor;
+        TSize iIconSize;
+    };
+
+#endif // CPbk2EcePresenceEngine_H
+           
+// End of File