1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 *

    16 */

    17 

    18 #ifndef CPHCNTFACTORY_H

    19 #define CPHCNTFACTORY_H

    20 

    21 //  INCLUDES

    22 #include    <e32base.h>

    23 #include    <cntdef.h>

    24 

    25 // FORWARD DECLARATIONS

    26 

    27 class CPhCntMatcher;

    28 class MProfileChangeObserver;

    29 class CPhCntContactId;

    30 

    31 // CLASS DECLARATION

    32 

    33 /**

    34 *  Factory class for creating phonebook related classes.

    35 *

    36 *  @lib PhoneCntFinder

    37 *  @since 1.0

    38 */

    39 class CPhCntFactory : public CBase

    40     {

    41     public:

    42 

    43 

    44         /** 

    45         * Creates an instance of Contact Matcher

    46         *

    47         * @return Contact Matcher object. Ownership is transferred.

    48         */

    49         virtual CPhCntMatcher* CreateContactMatcherL() = 0;

    50 

    51         /**

    52         * Creates an instance of profile engine notify handler.

    53         * @param aObserver observer to be notified of profile changes.

    54         * @return new instance.

    55         */

    56         virtual CBase* CreateProfileEngineNotifyHandlerL( 

    57             MProfileChangeObserver* aObserver ) = 0;

    58         

    59 

    60             

    61         /**

    62          * Creates contact id instance.

    63          *

    64          * @since S60 v3.1

    65          * @return New instance.

    66          */

    67         //virtual CPhCntContactId* CreateContactIdL() = 0;

    68             

    69         /**

    70          * Creates an contact id instance.

    71          *

    72          * @since S60 v3.1

    73          * @return New instance of CPhCntContactId

    74          */

    75         virtual CPhCntContactId* CreateContactIdL( TContactItemId aContactId ) = 0;

    76 

    77         /**

    78          * Create and contact id instance from contact link.

    79          *

    80          * @since S60 v3.2

    81          */

    82         virtual CPhCntContactId* CreateContactIdL( const TDesC8& aContactId ) = 0;    

    83 

    84  

    85     };

    86 

    87 /**

    88 * Creates CPhCntFactory. Position 1 in DLL's lookup table.

    89 * @return Reference to CPhCntFactory object. Ownership is transferred.

    90 */

    91 IMPORT_C CPhCntFactory* CreateCntFactoryL();

    92 

    93 #endif      // CPHCNTFACTORY_H

    94             

    95 // End of File