/*

* Copyright (c) 2004-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:  Maps a Contact Model field collection to a virtual Phonebook 

                 field collection.

*

*/

#ifndef VPBKCNTMODEL_TCONTACTFIELDCOLLECTION_H

#define VPBKCNTMODEL_TCONTACTFIELDCOLLECTION_H

// INCLUDES

#include <MVPbkStoreContactFieldCollection.h>

#include "TContactField.h"

// FORWARD DECLARATIONS

class CContactItemFieldSet;

namespace VPbkCntModel {

// FORWARD DECLARATIONS

class CContact;

// CLASS DECLARATIONS

/**

 * Maps a Contact Model field collection to a virtual Phonebook field collection.

 */

NONSHARABLE_CLASS( TContactFieldCollection ): 

        public MVPbkStoreContactFieldCollection

    {

    public:  // Constructor and destructor

        /**

         * Constructor.

         *

         * @param aParentContact    the contact whose field collection this is.

         * @parma aFieldSet         the Contact Model field set to map.

         */

        TContactFieldCollection

            (CContact& aParentContact, CContactItemFieldSet& aFieldSet);

        /**

         * Destructor.

         */

        ~TContactFieldCollection();

    public:  // New functions

        /**

         * Resets a new parent contact for this field collection.

         *

         * @param aParentContact    the contact whose field collection this is.

         * @parma aFieldSet         the Contact Model field set to map.

         */

        void SetContact

            (CContact& aParentContact, CContactItemFieldSet& aFieldSet);

        /**

         * Returns a pointer to the field that is used as a return value of 

         * FieldAt functions.

         *

         * @see CContact::AddFieldL

         */

        const MVPbkStoreContactField* FieldPointer() const;

    public:  // from MVPbkStoreContactFieldCollection

        MVPbkBaseContact& ParentContact() const;

        TInt FieldCount() const;

        const MVPbkStoreContactField& FieldAt(TInt aIndex) const;

        MVPbkStoreContactField& FieldAt(TInt aIndex);

        MVPbkStoreContactField* FieldAtLC(TInt aIndex) const;

        MVPbkStoreContact& ParentStoreContact() const;

        MVPbkStoreContactField* RetrieveField(

            const MVPbkContactLink& aContactLink) const;

    private:  // Data

        CContactItemFieldSet* iFieldSet;

        mutable TContactField iCurrentField;

        CContact* iParentContact;

    };

// INLINE FUNCTIONS

inline const MVPbkStoreContactField* TContactFieldCollection::FieldPointer() const

    {

    return &iCurrentField;

    }

} // namespace VPbkCntModel

#endif  // VPBKCNTMODEL_TCONTACTFIELDCOLLECTION_H

//End of file