williamr@2: /*
williamr@2: * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@4: * under the terms of "Eclipse Public License v1.0"
williamr@2: * which accompanies this distribution, and is available
williamr@4: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description:  Declaration of the CApNetworks class.
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: #ifndef CAPNETWORKS_H
williamr@2: #define CAPNETWORKS_H
williamr@2: 
williamr@2: // Deprecation warning
williamr@2: #warning This header file has been deprecated. Will be removed in one of the next SDK releases.
williamr@2:  
williamr@2:  
williamr@2: //  INCLUDES
williamr@2: #include <commdb.h>
williamr@2: #include <ApEngineVer.h>
williamr@2: #include <ApEngineConsts.h>
williamr@2: 
williamr@2: // FORWARD DECLARATIONS
williamr@2: class CApNetworkItem;
williamr@2: class CApNetworkItemList;
williamr@2: 
williamr@2: // CLASS DECLARATION
williamr@2: 
williamr@2: /**
williamr@2: *  This class is used to help client's network selection.
williamr@2: *
williamr@2: */
williamr@2: NONSHARABLE_CLASS( CApNetworks ) :public CBase
williamr@2:     {
williamr@2:     public:  // Constructors and destructor
williamr@2: 
williamr@2:         /**
williamr@2:         * Two-phased constructor. Leaves on failure, places instance
williamr@2:         * on cleanup stack.
williamr@2:         * @param aDb a reference to a CCommsDataBase.
williamr@2:         * @return The constructed CApNetworks.
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C static CApNetworks* NewLC( CCommsDatabase& aDb );
williamr@2: 
williamr@2: 
williamr@2:         /**
williamr@2:         * Destructor.
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C virtual ~CApNetworks();
williamr@2: 
williamr@2: 
williamr@2:     private:      // Constructors
williamr@2: 
williamr@2:         /**
williamr@2:         * C++ default constructor.
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C CApNetworks();
williamr@2: 
williamr@2:         /**
williamr@2:         * Second-phase constructor.
williamr@2:         * @param aDb The database
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C void ConstructL( CCommsDatabase& aDb );
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2:     public: // New functions
williamr@2: 
williamr@2:         /**
williamr@2:         * Counts the items in the list
williamr@2:         * @return The number of items in the list.
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C TUint32 Count() const;
williamr@2: 
williamr@2: 
williamr@2:         /**
williamr@2:         * Gets the name of the network group with the given UID
williamr@2:         * Ownership of the returned text is not passed.
williamr@2:         * @param aUid The uid of the network item 
williamr@2:         * @return The name of the network group
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C const TDesC& NameL( TUint32 aUid ) const;
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2:         /**
williamr@2:         * Provides all data in a CApNetworkItemList array.
williamr@2:         * @param aList A reference to a CApNetworkItemList object
williamr@2:         * to hold the values.
williamr@2:         * @return The number of items in the list.
williamr@2:         * All elements in the aList array and their memory
williamr@2:         * will be freed inside the routine.
williamr@2:         * The routine expands or shrinks the array as necessary
williamr@2:         * to minimize memory consumption.
williamr@2:         *
williamr@2:         * @deprecated
williamr@2:         */
williamr@2:         IMPORT_C TInt AllListItemDataL( CApNetworkItemList& aList );
williamr@2: 
williamr@2: 
williamr@2:     private:
williamr@2:         /**
williamr@2:         * This function updates the member data according to the
williamr@2:         * current filter settings.
williamr@2:         * @return Error code.
williamr@2:         */
williamr@2:         TInt DoUpdateL();
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2:     private:    // Data
williamr@2:         CCommsDatabase*             iDb;    // Does not own it!
williamr@2:         CApNetworkItemList*         iApList;
williamr@2:         TInt                        iCount;
williamr@2:     };
williamr@2: 
williamr@2: #endif      // CAPNETWORKS_H
williamr@2: 
williamr@2: // End of File