/*
* Copyright (c) 2002 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:  Add number to existing name and save the number.
*
*/


#ifndef CPHONECNTSAVEADDTONAME_H
#define CPHONECNTSAVEADDTONAME_H

// INCLUDES
#include <e32base.h>

// DATA TYPES
enum TCntNumberType
    {
    /**
    * If saved type is normal number.
    */
    ECntNormalNumber = 0,
    /**
    * If saved type is normal number it could be used in SIP Uri.
    */
    ECntVoiceInternetNumber,
    /**
    * If saved type is internet number.
    */
    ECntOnlyInternetNumber,
    /**
    * If saved type is internet number and could be used like
    * email address.
    */
    ECntInternetEmailField    
    };    

// KCntPhoneNumberMaxLength must be same as MPhEngCallHandling::TPhEngPhoneNumber  
const TInt KCntPhoneNumberMaxLength = 100;     
typedef TBuf<KCntPhoneNumberMaxLength> TCntPhoneNumber;

// FORWARD DECLARATIONS
class CPbkDataSaveAppUi;
class CPbkViewResourceLoader;
class MPhoneCntPbkOwner;
class MPhCntPhonebookServices;

// CLASS DECLARATION

/**
*  MPhoneCntSaveAddToName
*
*  Abstact class for saving new entry and adding data to old phonebook entry.
*
*  @lib PhoneCntFinder
*  @since 1.0
*/
NONSHARABLE_CLASS( MPhoneCntSaveAddToName )
    {
    public: // New functions   
    
        virtual ~MPhoneCntSaveAddToName()  {};
        
        /**
        * Handles phonebook operation
        * @param aTelNumber Telephone number to save
        * @param aCommand Given command (new, update existing)
        */
        virtual void HandlePbkOperationL( 
            const TCntPhoneNumber& aTelNumber,                                            
            TInt aCommand ) = 0;
            
        /**
        * Handles phonebook operation.
        * @since Series60 3.0
        * @param aTelNumber Telephone number to save
        * @param aCommand Given command (new, update existing)
        * @param aNumberType Type of saved telnumber (E.g If not numeric
        *                    could not save to the Phone number field)
        */       
        virtual void HandlePbkOperationL(
            const TCntPhoneNumber& aTelNumber,
            TInt aCommand,
            TCntNumberType aNumberType ) = 0;    
       };



/**
*  This class is used to add number to existing name and to save the number.
*
*  @lib PhoneCntFinder
*  @since 1.0
*/
class CPhoneCntSaveAddToName
    : public CBase, 
      public MPhoneCntSaveAddToName
    {
    public: // New functions       
        /**
        * Two-phased constructor.
        * @param aPbkOwner Phonebook owner.
        * @return new instance of the class.
        */
        static CPhoneCntSaveAddToName* NewL( MPhCntPhonebookServices& aServices );

        /**
        * Destructor.
        */
        IMPORT_C ~CPhoneCntSaveAddToName();

    public : // Functions from base classes

        /**
        * From MPhoneCntSaveAddToName
        */
        IMPORT_C void HandlePbkOperationL(
            const TCntPhoneNumber& aTelNumber,
            TInt aCommand );
        
        /**
        * From MPhoneCntSaveAddToName
        * @since 3.0
        */
        IMPORT_C void HandlePbkOperationL(
            const TCntPhoneNumber& aTelNumber,
            TInt aCommand,
            TCntNumberType aNumberType );    
    private:
        
        /**
        * C++ constructor.
        */
        CPhoneCntSaveAddToName( MPhCntPhonebookServices& aServices  );
        
    private://data
    
        /**
         * Service for creating and updating contacts.
         * Not own.
         */
        MPhCntPhonebookServices& iServices;

    };

#endif      // CPHONECNTSAVEADDTONAME_H
            
// End of File