phoneengine/PhoneCntFinder/inc/CPhoneCntFactory.h
changeset 0 5f000ab63145
equal deleted inserted replaced
-1:000000000000 0:5f000ab63145
       
     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