1 /*

     2 * Copyright (c) 2002-2006 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:  It's factory for creating components.

    15 *

    16 */

    17 

    18 

    19 #ifndef CPHCNTFACTORY_H

    20 #define CPHCNTFACTORY_H

    21 

    22 //  INCLUDES

    23 #include    <e32base.h>

    24 #include    <cntdef.h>

    25 

    26 // FORWARD DECLARATIONS

    27 class MPhCntThumbnailLoaderObserver;

    28 class CEikStatusPane;

    29 class CPhCntSpeedDialMonitor;

    30 class CPhCntThumbnailLoader;

    31 class CPhCntSingleItemFetch;

    32 class CPhCntRfsHandler;

    33 class CPhCntMmiSecurity;

    34 class CPhoneCntSaveAddToName; 

    35 class CPhoneCntVoiceKeyImp;

    36 class CPhCntMatcher;

    37 class CPhCntProfileEngine;

    38 class MProfileChangeObserver;

    39 class CPhCntContactId;

    40 class CPhCntContactDataSelection;

    41 class MPhCntStoreLoader;

    42 

    43 // CLASS DECLARATION

    44 

    45 /**

    46 *  Factory class for creating phonebook related classes.

    47 *

    48 *  @lib PhoneCntFinder

    49 *  @since 1.0

    50 */

    51 class CPhCntFactory : public CBase

    52     {

    53     public:

    54 

    55         /**

    56         * Creates speed dial monitor.

    57         *

    58         * @param aStatusPane statuspane.

    59         * @return speed dial monitor, ownership transferred.

    60         */

    61         virtual CPhCntSpeedDialMonitor* CreateSpeedDialMonitorL() = 0;

    62 

    63         /**

    64         * Creates thumbnail loader.

    65         *

    66         * @param aObserver observer.

    67         * @return thumbnail loader, ownership transferred.

    68         */

    69         virtual CPhCntThumbnailLoader* CreateThumbnailLoaderL(

    70             MPhCntThumbnailLoaderObserver& aObserver ) = 0;

    71             

    72         /**

    73         * Creates single item fetcher.     

    74         * 

    75         * @return single item fetcher, ownership transferred.

    76         */

    77         virtual CPhCntSingleItemFetch* CreateSingleItemFetchL() = 0;

    78 

    79         /**

    80         * Creates rfs handler.

    81         *

    82         * @return rfs handler, ownership is transferred.

    83         */

    84         virtual CPhCntRfsHandler* CreateRfsHandlerL() = 0;

    85 

    86         /**

    87         * Creates mmi security.

    88         *

    89         * @return mmi security.

    90         */

    91         virtual CPhCntMmiSecurity* CreateMmiSecurityL() = 0;

    92        

    93         /**

    94         * Creates save and add to name-object.

    95         *

    96         * @return pointer to class, ownership is transferred.

    97         */

    98         virtual CPhoneCntSaveAddToName* CreateSaveAddToNameL() = 0;

    99 

   100         /** 

   101         * Creates an instance of Contact Matcher

   102         *

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

   104         */

   105         virtual CPhCntMatcher* CreateContactMatcherL() = 0;

   106 

   107         /**

   108         * Creates an instance of profile engine.

   109         *

   110         * @return profile engine instance. Ownership is transferred.

   111         */

   112         virtual CPhCntProfileEngine* CreateProfileEngineL() = 0;

   113 

   114         /**

   115         * Creates an instance of profile engine notify handler.

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

   117         * @return new instance.

   118         */

   119         virtual CBase* CreateProfileEngineNotifyHandlerL( 

   120             MProfileChangeObserver* aObserver ) = 0;

   121             

   122         /**

   123          * Creates contact id instance.

   124          *

   125          * @since S60 v3.1

   126          * @return New instance.

   127          */

   128         virtual CPhCntContactId* CreateContactIdL() = 0;

   129             

   130         /**

   131          * Creates an contact id instance.

   132          *

   133          * @since S60 v3.1

   134          * @return New instance of CPhCntContactId

   135          */

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

   137 

   138         /**

   139          * Create and contact id instance from contact link.

   140          *

   141          * @since S60 v3.2

   142          */

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

   144 

   145         /**

   146          * Creates service to get user to select data from contact.

   147          * 

   148          * @since S60 v3.2

   149          */

   150         virtual CPhCntContactDataSelection* CreateContactDataSelectionL() = 0;

   151 

   152         /**

   153          * Creates a service to load contact stores.

   154          * 

   155          * @since S60 v9.1

   156          */

   157         virtual MPhCntStoreLoader* CreateContactStoreLoaderL() = 0;

   158         

   159         /**

   160          * Creates a phonebook service and opens contact stores.

   161          * 

   162          * @since S60 v9.1

   163          */

   164         virtual void CreatePhonebookServicesL() = 0;

   165     };

   166 

   167 /**

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

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

   170 */

   171 IMPORT_C CPhCntFactory* CreateCntFactoryL();

   172 

   173 #endif      // CPHCNTFACTORY_H

   174             

   175 // End of File