/*

* 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:  Manages adding new items to the contact

*

*/

#ifndef CPBK2ADDITEMMANAGER_H

#define CPBK2ADDITEMMANAGER_H

//  INCLUDES

#include <e32base.h>

#include <MPbk2FieldProperty.h>

#include "TPbk2ContactEditorParams.h"

// FORWARD DECLARATIONS

class CPbk2PresentationContact;

class MPbk2ContactEditorFieldArray;

class MPbk2FieldPropertyArray;

class TPbk2AddItemWrapper;

class MVPbkStoreContact;

class CPbk2FieldGroupPropertyArray;

class MPbk2ApplicationServices;

// CLASS DECLARATION

/**

 *  Manages adding new items to the contact.

 *

 */

NONSHARABLE_CLASS(CPbk2AddItemManager) : public CBase

    {

    public:  // Constructors and destructor

    	class TReturnValue

    		{

    		public:

    			TReturnValue()

    			:iGruopId(EPbk2FieldGroupIdNone), 

    			iControlId(KErrNone)

				{}

    		public:

    			TInt iControlId;

    			TPbk2FieldGroupId iGruopId;

	};

        /**

         * Creates a new instance of this class.

         *

         * @param aContact          The contact to add fields.

         * @param aFieldArray       The field array for adding new fields.

         * @return  A new instance of this class.

         */

        static CPbk2AddItemManager* NewL(

                CPbk2PresentationContact& aContact,

                MPbk2ContactEditorFieldArray& aFieldArray, 

                TPbk2ContactEditorParams& aParams,

                MPbk2ApplicationServices* aAppServices );

        /**

         * Destructor.

         */

        ~CPbk2AddItemManager();

    public: // Interface

        /**

         * Executes the add item dialog and returns the control id

         * of the field that was added upmost.

         *

         * @param aFieldTypeResId   Add item field type resource id.

         *                          If positive or zero, the list box

         *                          will not be run, but a corresponding

         *                          control id will be returned.

         *                          If negative, the list box will be run

         *                          and selected index will be returned.

         * @param aFieldTypeXspName Add item field type xSP name.

         * @return  The control id.

         */

    	TReturnValue AddFieldsL(

                TInt& aFieldTypeResId, TPtrC& aFieldTypeXspName);

    private:  // Implementation

        CPbk2AddItemManager(

                CPbk2PresentationContact& aContact,

                MPbk2ContactEditorFieldArray& aFieldArray, 

                TPbk2ContactEditorParams& aParams,

                MPbk2ApplicationServices* aAppServices );

        TReturnValue AddFieldsToUiAndContactL(

                const TPbk2AddItemWrapper& aWrapper );

        TReturnValue RunDialogAndAddFieldsL(

                RArray<TPbk2AddItemWrapper>& aWrappers,

                TInt& aFieldTypeResId,

                TPtrC& aFieldTypeXspName );

        void AddPhoneMemoryFieldTypesL(

                CArrayPtr<const MPbk2FieldProperty>& aProperties );

        TReturnValue DoAddFieldsL(

                CArrayPtr<const MPbk2FieldProperty>& aProperties,

                TInt& aFieldTypeResId,

                TPtrC& aFieldTypeXspName );

        TBool IsFieldAdditionPossibleL(

                const CPbk2PresentationContact& aContact,

                const MPbk2FieldProperty& aProperty );

        void MakePhoneContactL(

                const CPbk2PresentationContact& aContact );

    private: // Data

        /// Ref: The contact to add fields

        CPbk2PresentationContact* iContact;

        /// Ref: The UI field array for adding new fields

        MPbk2ContactEditorFieldArray* iFieldArray;

        /// Ref: The field properties

        const MPbk2FieldPropertyArray* iProperties;

        /// Own: Temporary phone memory presentation contact

        CPbk2PresentationContact* iTemporaryPresentationContact;

        /// Own: Temporary phone memory store contact

        MVPbkStoreContact* iTemporaryStoreContact;

        /// Own: field group properties

        CPbk2FieldGroupPropertyArray* iGroupProperties;

        /// Own: field type xSP name

        HBufC* iXSpName;

        /// Ref: Editor parameters

        TPbk2ContactEditorParams& iParams;

        // Ref: Pbk2 application services

        MPbk2ApplicationServices* iAppServices;

    };

#endif // CPBK2ADDITEMMANAGER_H

// End of File