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:  Abstract base class for param factory

    15 *

    16 */

    17 

    18 

    19 #ifndef MPHCNTSERVICEREQUESTPARAMFACTORY_H

    20 #define MPHCNTSERVICEREQUESTPARAMFACTORY_H

    21 

    22 #include "CPhCntSingleItemFetch.h"

    23 #include "cphcntcontactdataselection.h"

    24 

    25 class MPhCntServiceRequestParam;

    26 class MVPbkContactLinkArray;

    27 class MPhCntContactManager;

    28 

    29 /**

    30  *  Abstract base class for creating AIW service request params.

    31  *

    32  *  @lib PhoneCntFinder

    33  *  @since S60 v3.1

    34  */

    35 NONSHARABLE_CLASS( MPhCntServiceRequestParamFactory )

    36     {

    37 public:

    38 

    39     virtual ~MPhCntServiceRequestParamFactory() {};

    40     

    41     /**

    42      * Creates new parameter for creating new contact.

    43      *

    44      * @since S60 v3.1

    45      * @param aPhoneNumber Phone number of new contact.

    46      * @return New instance.

    47      */

    48     virtual MPhCntServiceRequestParam* 

    49         CreateCreateNewContactRequestParamLC( const TDesC& aPhoneNumber ) const = 0;

    50         

    51     /**

    52      * Creates new paramater for updating existing contact.

    53      *

    54      * @since S60 v3.1

    55      * @param aPhoneNumber Phone number added to existing contact.

    56      * @return New param.

    57      */   

    58     virtual MPhCntServiceRequestParam* 

    59         CreateUpdateContactRequestParamLC( const TDesC& aPhoneNumber ) const = 0;

    60         

    61     /**

    62      * Creates new parameter for fetching user selected phone number link.

    63      *

    64      * @since S60 v3.1

    65      * @return New parameter instance.

    66      */

    67     virtual MPhCntServiceRequestParam* 

    68         CreateGetUserSelectedPhoneNumberLinkParamLC() const = 0;

    69         

    70     /**

    71      * Creates new parameter for fetching user selected dtmf number link.

    72      *

    73      * @since S60 v3.2

    74      * @param aContactManager Contact manager reference.

    75      * @return New parameter instance.

    76      */

    77     virtual MPhCntServiceRequestParam* 

    78         CreateGetUserSelectedDtmfNumberLinkLC( 

    79             MPhCntContactManager& aContactManager ) const = 0;

    80 

    81     /**

    82      * Creates new parameter for fetching user selected voip address link.

    83      *

    84      * @since S60 v5.0

    85      * @param aContactManager Contact manager reference.

    86      * @return New parameter instance.

    87      */  

    88     virtual MPhCntServiceRequestParam* 

    89         CreateGetUserSelectedVoIPAddressLinkParamLC( 

    90             MPhCntContactManager& aContactManager ) const = 0;

    91 

    92     /**

    93      * Creates parameter for fetching user selected VoIPumber.

    94      * The left soft key is 'Select."

    95      *

    96      * @since S60 v5.0

    97      * @param aContactManager Contact manager reference.

    98      * @return New parameter instance.

    99      */

   100     virtual MPhCntServiceRequestParam* 

   101         CreateGetUserSelectedVoIPAddressLC( 

   102             MPhCntContactManager& aContactManager ) const = 0;

   103 

   104     /**

   105      * Creates new parameter for fetching a phone number from

   106      * known contact, which is identified by contact link.

   107      * @since S60 v3.2

   108      * @param aContactLink Link to a contact.

   109      * @param aCallType Number type.

   110      * @return New parameter instance.

   111      */         

   112     virtual MPhCntServiceRequestParam*         

   113         CreateGetPhoneNumberFromContactParamLC( 

   114             const TDesC8& aContactLink,

   115             const CPhCntSingleItemFetch::TCallType aCallType ) const = 0;

   116     

   117     /**

   118      * Creates new parameter for fetching a phone number from

   119      * known contact, which is identified by contact link.

   120      * @since S60 v3.2

   121      * @param aContactLink Link to a contact.

   122      * @param aCallType Number type.

   123      * @return New parameter instance.

   124      */    	

   125     virtual MPhCntServiceRequestParam* CreateGetPhoneNumberFromContactParamL(

   126         const TDesC8& aContactLink,

   127         const CPhCntSingleItemFetch::TCallType aCallType ) const = 0;

   128         	

   129     };

   130 

   131 

   132 #endif // MPHCNTSERVICEREQUESTPARAMFACTORY_H