1 /*

     2 * Copyright (c) 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:  Factory for creating service request params.

    15 *

    16 */

    17 

    18 

    19 #ifndef TPHCNTSERVICEREQUESTPARAMFACTORY_H

    20 #define TPHCNTSERVICEREQUESTPARAMFACTORY_H

    21 

    22 #include <e32base.h>

    23 

    24 #include "mphcntservicerequestparamfactory.h"

    25 

    26 class MPhCntServiceRequestParam;

    27 class MPhCntContactManager;

    28 

    29 /**

    30  *  Factory class for creating service request params.

    31  *

    32  *  @lib PhoneCntFinder.lib

    33  *  @since S60 v3.1

    34  */

    35 NONSHARABLE_CLASS( CPhCntServiceRequestParamFactory ): 

    36     public CBase, 

    37     public MPhCntServiceRequestParamFactory

    38     {

    39 public:

    40  

    41     /**

    42      * Static constructor.

    43      * @since S60 v3.2

    44      */

    45     static CPhCntServiceRequestParamFactory* NewL( 

    46         MPhCntContactManager& aContactManager );

    47     

    48     /**

    49      * Static constructor.

    50      * @since S60 v3.2

    51      */

    52     static CPhCntServiceRequestParamFactory* NewLC( 

    53         MPhCntContactManager& aContactManager );

    54    

    55     /**

    56      * Destructor.

    57      *

    58      * @since S60 v3.1

    59      */

    60     ~CPhCntServiceRequestParamFactory();

    61     

    62 // From base class MPhCntServiceRequestParamFactory

    63 

    64     /**

    65      * From base class MPhCntServiceRequestParamFactory

    66      *

    67      * @since S60 v3.1

    68      * @see MPhCntServiceRequestParamFactory

    69      */

    70     MPhCntServiceRequestParam* 

    71         CreateCreateNewContactRequestParamLC( const TDesC& aPhoneNumber ) const;

    72         

    73     /**

    74      * From base class MPhCntServiceRequestParamFactory

    75      *

    76      * @since S60 v3.1

    77      * @see MPhCntServiceRequestParamFactory

    78      */  

    79     MPhCntServiceRequestParam* 

    80         CreateUpdateContactRequestParamLC( const TDesC& aPhoneNumber ) const;

    81         

    82     /**

    83      * From base class MPhCntServiceRequestParamFactory

    84      *

    85      * @since S60 v3.1

    86      * @see MPhCntServiceRequestParamFactory

    87      */  

    88     MPhCntServiceRequestParam* 

    89         CreateGetUserSelectedPhoneNumberLinkParamLC() const;

    90         

    91     /**

    92      * Creates paramter for fetching user selected phonenumber.

    93      * The left soft key is 'Select."

    94      *

    95      * @since S60 v3.2

    96      * @return New instance of request parameter. Ownership given.

    97      */

    98     MPhCntServiceRequestParam* 

    99         CreateGetUserSelectedPhoneNumberLC() const;

   100     

   101     /**

   102      * From base class MPhCntServiceRequestParamFactory

   103      *

   104      * @since S60 v3.1

   105      * @see MPhCntServiceRequestParamFactory

   106      */ 

   107     MPhCntServiceRequestParam* 

   108         CreateGetUserSelectedDtmfNumberLinkLC( 

   109             MPhCntContactManager& aContactManager ) const;

   110 

   111     /**

   112      * From base class MPhCntServiceRequestParamFactory

   113      *

   114      * @since S60 v3.2

   115      * @see MPhCntServiceRequestParamFactory

   116      */  

   117     MPhCntServiceRequestParam* 

   118         CreateGetUserSelectedVoIPAddressLinkParamLC( 

   119             MPhCntContactManager& aContactManager ) const;

   120 

   121     /**

   122      * Creates paramter for fetching user selected VoIPumber.

   123      * The left soft key is 'Select."

   124      *

   125      * @since S60 v3.2

   126      * @return New instance of request parameter. Ownership given.

   127      */

   128     MPhCntServiceRequestParam* 

   129         CreateGetUserSelectedVoIPAddressLC( 

   130             MPhCntContactManager& aContactManager ) const;

   131     

   132     /**

   133      * From base class MPhCntServiceRequestParamFactory

   134      *

   135      * @since S60 v3.2

   136      * @see MPhCntServiceRequestParamFactory

   137      */

   138     MPhCntServiceRequestParam*         

   139         CreateGetPhoneNumberFromContactParamLC( const TDesC8& aContactLink,

   140             const CPhCntSingleItemFetch::TCallType aCallType ) const;

   141     /**

   142      * From base class MPhCntServiceRequestParamFactory

   143      *

   144      * @since S60 v3.2

   145      * @see MPhCntServiceRequestParamFactory

   146      */   	

   147     MPhCntServiceRequestParam* CreateGetPhoneNumberFromContactParamL(

   148         const TDesC8& aContactLink,

   149         const CPhCntSingleItemFetch::TCallType aCallType ) const;

   150             

   151         

   152 protected:

   153         

   154     CPhCntServiceRequestParamFactory( MPhCntContactManager* aContactManager );

   155     

   156 private: // Data

   157 

   158     /**

   159      * Contact manager.

   160      * Not own.

   161      */

   162     MPhCntContactManager* iContactManager;

   163 

   164     };

   165 

   166 #endif // TPHCNTSERVICEREQUESTPARAMFACTORY_H