phoneengine/phonecntfinder2/inc/cphcntmatcherimpl2.h
author William Roberts <williamr@symbian.org>
Thu, 22 Jul 2010 16:33:21 +0100
branchGCC_SURGE
changeset 51 f39ed5e045e0
parent 21 92ab7f8d0eab
permissions -rw-r--r--
Catchup to latest Symbian^4

/*
* Copyright (c) 2009 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:
*
*/

#ifndef CPHCNTMATCHERIMPL_H
#define CPHCNTMATCHERIMPL_H

//  INCLUDES
#include "cphcntmatcher.h"
#include <centralrepository.h>
#include <cenrepnotifyhandler.h>
#include <qmobilityglobal.h>

// FORWARD DECLARATIONS
class CPhCntContactId;
class CPhCntMatch2;

QTM_BEGIN_NAMESPACE
class QContactManager;
QTM_END_NAMESPACE
QTM_USE_NAMESPACE

// CLASS DECLARATION


/**
*  Implementation for making matches.
*
*  @lib PhoneCntFinder
*  @since 1.0
*/
NONSHARABLE_CLASS( CPhCntMatcherImpl2 ) :
    public CPhCntMatcher
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        * @pre aContactManager != NULL
        * @param aContactManager provides matching services. Ownership is transferred.
        * @return New instance
        */
        static CPhCntMatcherImpl2* NewL(QContactManager* aContactManager);
        
        /**
        * Destructor.
        */
        virtual ~CPhCntMatcherImpl2();


    public: // Functions from base classes

        /**
        * From CPhCntMatcher
        */
        TInt MatchNumber( MPhCntMatch*& aMatch,const TDesC& aTelNumber );

        /**
        * From CPhCntMatcher
        */
        TInt MatchNumber( 
            MPhCntMatch*& aMatch,
            const TDesC& aTelNumber,
            const CPhCntContactId& aContactId );

        /**
        * From CPhCntMatcher
        */
        TInt MatchNumber(
            MPhCntMatch*& aMatch,
            const TDesC& aTelNumber,
            const CPhCntContactId& aContactId,
            const TFieldId aFieldId );

            
        /**
        * Match number to phonebook.
        * @param aMatch Found match, owership tranferred. NULL if not found any.
        * @param aNumber Number to match against.
        * @return Error code: KErrNone - one match found
        *                     KErrNotFound - no matches found
        *                     other - normal Symbian OS error
        */    
        TInt MatchVoipNumber(
            MPhCntMatch*& aMatch,
            const TDesC& aNumber,
            TBool aAllowUserNameMatch,
            TInt aCharsForMatching = 0 );
        
         /**
        * From CPhCntMatcher, gets VoIP call contact info from phonebook
        * by contact id.
        * @since Series60 3.0
        * @param aMatch for found match, owership tranferred. Empty if not found.
        * @param aContactId for current contact.
        * @return Error code: KErrNone - VoIP call contact found
        *                     KErrNotFound - no VoIP call contact found
        *                     other - normal Symbian OS error
        */    
        TInt MatchVoipNumber(
            MPhCntMatch*& aMatch,
            const CPhCntContactId& aContactId );

        /**
          * Determines if contact has other type of numbers
          * than VoIP numbers.
          * 
          * @since S60 v3.2.
          * @param aContactId Id of the contact.
          * @return ETrue - CS numbers found from contact.
          *         EFalse - No CS numbers found from contact.
          */
         virtual TBool HasCSNumbers( 
             const CPhCntContactId& aContactId );
             
        /**
        * @see CPhCntMatcher::MatchNumber
        */
        TInt MatchNumber( 
            MPhCntMatch*& aMatch, 
            const TDesC& aTelNumber,
            TInt aContactId );


    private:

        /**
        * C++ constructor.
        */
        CPhCntMatcherImpl2(QContactManager* aContactManager);

        /**
        * By default Symbian OS constructor is private.
        */
        void ConstructL();
        

    private:
        CPhCntMatch2* iMatch; //only one now, must delete anyway.
        QContactManager* iContactManager;

  
    };

#endif      // CPHCNTMATCHERIMPL_H

// End of File