/*

* Copyright (c) 2003 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:  Servers-array wrapper

*

*/

#ifndef CCASERVERSARRAY_H

#define CCASERVERSARRAY_H

//  INCLUDES

#include <e32base.h>

#include <badesca.h>

#include "CWVSettingsUIDefs.h"

// CLASS DECLARATION

/**

*  Servers-array wrapper

*  Wraps real array handling to MDesCArray protocol

*

*  @lib WVServiceSettingsUi.dll

*  @since 2.1

*/

NONSHARABLE_CLASS( CWVSettingsUIServersArray ) : public CBase, public MDesCArray

    {

public:  // Constructors and destructor

    /**

    * Two-phased constructor.

    * @param aServerList List of servers

    * @param aProtectedServers a list of protected servers

    */

    static CWVSettingsUIServersArray* NewL( MDesCArray& aServerList,

    RArray<TInt>& aProtectedServers );

    /**

    * Destructor.

    */

    virtual ~CWVSettingsUIServersArray();

public: // Functions from base classes (MDesCArray)

    /**

    * From MDesCArray, Returns the number of descriptor elements in

    * a descriptor array.

    * @return Count of items

    */

    TInt MdcaCount() const;

    /**

    * From MDesCArray, Indexes into a descriptor array.

    * Return listbox-formatted data

    * @param aIndex The position of the descriptor element within a

    * descriptor array

    * @return A 16 bit non-modifiable pointer descriptor representing

    * the descriptor element located at position aIndex within a

    * descriptor array.

    */

    TPtrC16 MdcaPoint( TInt aIndex ) const;

public: // New methods

    /**

    * Returns raw unformatted data

    * @since 2.1

    * @param aIndex The position of the descriptor element within a

    * descriptor array

    * @return A 16 bit non-modifiable pointer descriptor representing

    * the descriptor element located at position aIndex within a

    * descriptor array.

    */

    TPtrC16 RawDataMdcaPoint( TInt aIndex ) const;

    /**

    * Replaces adapter model

    * @since 2.1

    * @param aServerList New model

    */

    void ReplaceModelL( MDesCArray* aServerList );

private:

    /**

    * C++ default constructor.

    * @param aServerList List of servers

    */

    CWVSettingsUIServersArray( MDesCArray& aServerList, RArray<TInt>& aProtectedServers );

    /**

    * By default Symbian OS constructor is private.

    */

    void ConstructL();

private:    // Data

    // Doesn't own. Handle to engines contact-list array

    MDesCArray* iServerList;

    // Owns. server name

    HBufC* iData;

    // doesn't own. Array of protected servers

    RArray<TInt>* iProtectedServers;

    };

#endif      // CCASERVERSARRAY_H

// End of File