connectionmonitoring/connectionmonitorui/inc/ConnectionArray.h
changeset 0 5a93021fdf25
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/connectionmonitoring/connectionmonitorui/inc/ConnectionArray.h	Thu Dec 17 08:55:21 2009 +0200
@@ -0,0 +1,153 @@
+/*
+* Copyright (c) 2004 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:  Contains and handles CConnectionInfo instances
+*     
+*
+*/
+
+
+#ifndef CONNECTIONARRAY_H_INCLUDED
+#define CONNECTIONARRAY_H_INCLUDED
+
+// INCLUDES
+#include    "ConnectionInfoBase.h"
+
+
+// CONSTANTS
+
+// FORWARD DECLARATIONS
+
+// CLASS DECLARATION
+/**
+* Contains and handles CConnectionInfo instances.
+*/
+class CConnectionArray : public CBase, public MDesCArray
+    {
+    public:
+        /**
+        * Constructor.
+        */
+        CConnectionArray();
+
+        /**
+        * Destructor.
+        */
+        virtual ~CConnectionArray();
+
+        /**
+        * Contructs dynamic data members
+        */
+        virtual void ConstructL();
+   
+    public: // from MDesCArray
+        /** 
+        * Returns the number of descriptor elements in a descriptor array.
+        * @return The number of descriptor elements in a descriptor array. 
+        */
+        virtual TInt MdcaCount() const;
+
+        /** 
+        * Indexes into a descriptor array.    
+        * @param aIndex The position of the descriptor element within a 
+        * descriptor array. 
+        * The position is relative to zero; i.e. zero implies the first 
+        * descriptor element in a descriptor array. 
+        * @return A  non-modifiable pointer descriptor representing 
+        * the descriptor element located at position aIndex within a 
+        * descriptor array. 
+        */
+        virtual TPtrC MdcaPoint( TInt aIndex ) const;
+
+    public:
+    
+        /**
+        * Give back a copy of connectionarray. 
+        */
+        virtual CConnectionArray* DeepCopyL();
+    
+        /**
+        * Returns the index of the given connection
+        * @param aConnectionId connection id
+        * @return index value of connection in the array, or -1 if there
+        * is no connection the given Id
+        */
+        TInt GetArrayIndex( TUint aConnectionId ) const;
+
+        /**
+        * Returns the index of the given connection
+        * @param aConnection connection 
+        * @return index value of connection in the array, or -1 if there
+        * is no the given connection 
+        */
+        TInt GetArrayIndex( CConnectionInfoBase* aConnection ) const;
+
+        /**
+        * Add only new connection to the array
+        * @param aConnection the connection to be added to the array
+        */
+        void AppendL( CConnectionInfoBase* aConnection );
+
+        /**
+        * Delete connection from the array
+        * @param aConnectionId id of connection to be removed from the array
+        */
+        void Delete( TUint aConnectionId );
+
+        /**
+        * Delete connection from the array
+        * @param aConnection the connection to be removed from the array
+        */
+        void Delete( CConnectionInfoBase* aConnection );
+
+        /**
+        * Destroys the connection array
+        */
+        void Reset();
+
+        /**
+        * Returns info object of connection given by index value in the array
+        * @param aIndex index value of connection in the array
+        * @return CConnectionInfo* pointer to the connection info object
+        */
+        CConnectionInfoBase* operator[]( TUint aIndex ) const;
+        
+        /**
+        * Returns info object of connection given by index value in the array
+        * Checks the boundaries of array.
+        * @param aIndex index value of connection in the array
+        * @return CConnectionInfoBase* pointer to the connection info object if
+        * the given index is valid, NULL otherwise
+        */
+        CConnectionInfoBase* At( TInt aIndex ) const;
+        
+        /**
+        * Gives back the number of active connections (created or suspended)
+        * @return the number of active connections
+        */
+        TInt NumberOfActiveConnections() const;
+
+        /**
+        * Gives back the number of suspended connections
+        * @return the number of suspended connections
+        */
+        TInt NumberOfSuspendedConnections() const;
+
+    protected:
+        /**
+        * Contains the connections.
+        */
+        CArrayPtrFlat<CConnectionInfoBase>* iConnectionArray;   ///< Owned.
+    };
+
+#endif // CONNECTIONARRAY_H_INCLUDED
\ No newline at end of file