1 /*

     2 * Copyright (c) 2008 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:  Manual call control handler

    15 *

    16 */

    17 

    18 

    19 #ifndef CPEMANUALCALLCONTROLHANDLER_H

    20 #define CPEMANUALCALLCONTROLHANDLER_H

    21 

    22 //  INCLUDES

    23 #include <cphcltcommandhandler.h>

    24 

    25 // CONSTANTS

    26 // None.

    27 

    28 // MACROS

    29 // None.

    30 

    31 // DATA TYPES

    32 // None.

    33 

    34 // FUNCTION PROTOTYPES

    35 // None.

    36 

    37 // FORWARD DECLARATIONS

    38 class CPEMessageHandler;

    39 class MPECallHandling;

    40 class MPEDataStore;

    41 

    42 // CLASS DECLARATION

    43 

    44 /**

    45 *  Handles Manual call control sequences.

    46 *

    47 *  @lib phoneenginebase.dll

    48 *  @since Series60_5.0

    49 */

    50 NONSHARABLE_CLASS( CPEManualCallControlHandler ) : public CBase

    51     {

    52     public:  // Destructor

    53 

    54         /**

    55         * Destructor.

    56         */

    57         virtual ~CPEManualCallControlHandler();

    58         

    59         /**

    60         * Two-phased constructor.

    61         */

    62         static CPEManualCallControlHandler* NewL( 

    63                 MPECallHandling& aCallHandling, 

    64                 CPEMessageHandler& aMessageHandler,

    65                 MPEDataStore& aDataStore );

    66 

    67     public: // New functions

    68 

    69         /**

    70         * Handles Chld AT message.

    71         * @since Series60_5.0

    72         * @param aChldCommand Chld message

    73         * @param aCallNo Call Nro.

    74         */

    75         void HandleChldL( 

    76             const TPhCltChldCommand aChldCommand,

    77             const TUint aCallNo );

    78 

    79         /**

    80         * Handles Going private in Conference Call

    81         * @since Series60_5.0

    82         * @return possible error code from the CallHandling subsystem.

    83         */

    84         TInt HandleGoOneToOne();

    85             

    86         /**

    87         * Release held calls or reject a waiting call.

    88         */

    89         TInt HandleChldZero();

    90         

    91         /**

    92         * Release all active calls and accept other (held or waiting) call.

    93         */

    94         TInt HandleChldOne();

    95         

    96         /**

    97         * Release specific active call or accept specific waiting call.

    98         */

    99         void HandleChldOneXL( TInt aCallNo );

   100         

   101         /**

   102         * Place all active calls on hold(SWAP) and accept the other 

   103         * (held or waiting) call.

   104         */

   105         TInt HandleChldTwo();

   106         

   107         /**

   108         * Hold all active calls except specific call.

   109         */

   110         void HandleChldTwoXL( TInt aCallNo );

   111         

   112         /**

   113         * Add a held call to the conversation.

   114         */

   115         TInt HandleChldThree();

   116         

   117         /**

   118         * Connect held and active call each other. Locally both calls are disconnect

   119         * (Explicit call transfer).

   120         */

   121          TInt HandleChldFour();

   122 

   123          /**

   124          * Fetch call id using given call index

   125          */

   126          TInt CallIdByIndexL( const TInt& aCallIndex );

   127         

   128         

   129     public: // Functions from base classes

   130         // None.        

   131     protected:  // New functions

   132         // None.

   133     private:  // Functions from base classes

   134         // None.

   135 

   136     private: //Constructors

   137 

   138         /**

   139         * C++ default constructor.

   140         */

   141         CPEManualCallControlHandler( MPECallHandling& aCallHandling, 

   142                 CPEMessageHandler& aMessageHandler,

   143                 MPEDataStore& aDataStore );

   144     

   145     protected:  // Data

   146         // None.

   147     private:    // Data

   148         // MPECallHandling handles call related commands to CallHandling subsystem.

   149         MPECallHandling& iCallHandling;

   150         // MEngineMonitor handles interface structures to phone application

   151         CPEMessageHandler& iMessageHandler;

   152         // reference to data store

   153         MPEDataStore& iDataStore;

   154     public:     // Friend classes

   155         // None.

   156     protected:  // Friend classes

   157         // None.

   158     private:    // Friend classes

   159         // None.

   160 

   161     };

   162 

   163 #endif      // CPEMANUALCALLCONTROLHANDLER_H   

   164             

   165 // End of File