phoneengine/callhandling/inc/cpecallarrayowner.h
changeset 0 5f000ab63145
equal deleted inserted replaced
-1:000000000000 0:5f000ab63145
       
     1 /*
       
     2 * Copyright (c) 2007-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:  This file contains the header file of the CPECallArrayOwner object
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 #ifndef CPECALLARRAYOWNER_H
       
    20 #define CPECALLARRAYOWNER_H
       
    21 
       
    22 //INCLUDES
       
    23 #include <pevirtualengine.h>
       
    24 #include <mccecall.h>
       
    25 #include <mpecallowner.h>
       
    26 #include "cpesinglecall.h"
       
    27 
       
    28 // CONSTANTS
       
    29 // None
       
    30 
       
    31 // MACROS
       
    32 // None
       
    33 
       
    34 // DATA TYPES
       
    35 // None.
       
    36 
       
    37 // FUNCTION PROTOTYPES
       
    38 // None. 
       
    39 
       
    40 // FORWARD DECLARATIONS
       
    41 
       
    42 // CLASS DECLARATION
       
    43 class MPEMessageSender;
       
    44 class CCCE;
       
    45 
       
    46 /**
       
    47 *  Create call handling requests to Call Command object
       
    48 *  @lib CallHandling.lib
       
    49 *  @since Series60_4.0
       
    50 */
       
    51 class CPECallArrayOwner 
       
    52         : public CBase,
       
    53           public MPECallOwner
       
    54     {
       
    55     public:
       
    56         /**
       
    57         * Destructor.
       
    58         */
       
    59         virtual ~CPECallArrayOwner();
       
    60         
       
    61         /**
       
    62         * Two-phased constructor.
       
    63         */
       
    64         static CPECallArrayOwner* NewL( 
       
    65             CCCE& iConvergedCallEngine, 
       
    66             MPEMessageSender& aOwner );
       
    67 
       
    68     private: //Constructors and descructor
       
    69 
       
    70         /**
       
    71         * By default Symbian 2nd phase constructor is private.
       
    72         */
       
    73         void ConstructL(
       
    74             CCCE& iConvergedCallEngine, 
       
    75             MPEMessageSender& aOwner );
       
    76     
       
    77         /**
       
    78         * C++ default constructor.
       
    79         */
       
    80         CPECallArrayOwner();
       
    81 
       
    82     public:    //New functions
       
    83     
       
    84         /**
       
    85         * 
       
    86         * @param aCallId, the call id number
       
    87         */    
       
    88         CPESingleCall* CreateCallL( MPEMessageSender& aOwner );
       
    89         
       
    90         /**
       
    91         * 
       
    92         * @param aCallId, the call id number
       
    93         */    
       
    94         CPESingleCall* GetCallObject( const TInt aCallId ) const;
       
    95 
       
    96         /**
       
    97         * 
       
    98         * @param aIndex, index to call array
       
    99         */    
       
   100         CPESingleCall* GetCallObjectByIndex( const TInt aIndex ) const;
       
   101 
       
   102         /**
       
   103         * 
       
   104         * @param aCallId, the call id number
       
   105         */    
       
   106         TInt DeleteCallObject( const TInt aCallId );
       
   107         
       
   108         /**
       
   109         * Return call count
       
   110         * @param None
       
   111         */ 
       
   112         TInt Count() const;
       
   113         
       
   114         /**
       
   115         * Create data call object
       
   116         * @param aOwner
       
   117         */ 
       
   118         CPESingleCall* CreateDataCallL( MPEMessageSender& aOwner );
       
   119         
       
   120         /**
       
   121         * returns CPESingleCall call object by State, NULL if not found.
       
   122         * @param aState
       
   123         */ 
       
   124         CPESingleCall* CallPointerByState( TPEState aState ) const;
       
   125         
       
   126         /**
       
   127         * returns CPESingleCall call object by Name, NULL if not found.
       
   128         * @param aState
       
   129         */
       
   130         CPESingleCall* CallPointerByName( const TName& aName ) const;
       
   131        
       
   132     public:    // MPECallArrayOwner
       
   133         
       
   134         /**
       
   135         * returns ETrue if call object found by state, NULL if not found.
       
   136         * @param aState, the wanted call state.
       
   137         */ 
       
   138         IMPORT_C TBool IsCallByState( 
       
   139             const TPEState aState ) const;
       
   140         
       
   141         /**
       
   142         * returns ETrue if call object found by call ID, NULL if not found.
       
   143         * @param aCallId, the wanted call id.
       
   144         */    
       
   145         IMPORT_C TBool IsCallByCallId( 
       
   146             const TInt aCallId ) const;
       
   147             
       
   148         /**
       
   149         * returns pointer to MPECall object by CallId, NULL if not found.
       
   150         * @param aName, the wanted name.
       
   151         */    
       
   152         IMPORT_C MPECall* CallByName( 
       
   153             const TName& aName ) const;
       
   154         
       
   155         /**
       
   156         * Return active call count, other then idle state.
       
   157         * @param None
       
   158         */ 
       
   159         IMPORT_C TInt ActiveCallCount() const;
       
   160         
       
   161         /**
       
   162         * returns pointer to MPECall object by CallId, NULL if not found.
       
   163         * @param aCallId, the call id number
       
   164         */    
       
   165         IMPORT_C MPECall* CallByCallId( const TInt aCallId ) const;
       
   166         
       
   167         /**
       
   168         * returns pointer to MPECall object by state, NULL if not found.
       
   169         * @param aState
       
   170         */ 
       
   171         IMPORT_C MPECall* CallByState( TPEState aState ) const;
       
   172 
       
   173     private:
       
   174         
       
   175         /**
       
   176         * Create emergency call object
       
   177         * @param aOwner
       
   178         */    
       
   179         CPESingleCall* CreateEmergencyCallL( MPEMessageSender& aOwner );
       
   180         
       
   181     private: // Data
       
   182 
       
   183         // RPointerArray object which contains CPESingleCall objects.
       
   184         RPointerArray<CPESingleCall>* iCallArray; 
       
   185 
       
   186     };
       
   187 
       
   188 #endif // CPECALLARRAYOWNER_H
       
   189 
       
   190 //    End of File