1 /*

     2 * Copyright (c) 2002 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 is the class for active object for making calls.

    15 *

    16 */

    17 

    18 

    19 #ifndef CPHCLTEXTPHONE_H   

    20 #define CPHCLTEXTPHONE_H   

    21 

    22 //  INCLUDES

    23 #include <e32base.h>

    24 #include "CPhCltExtPhoneBase.h"

    25 #include "RPhCltServer.h"

    26 #include "RPhCltExtCall.h"

    27 

    28 

    29 // FORWARD DECLARATIONS

    30 class MPhCltExtPhoneObserver;

    31 

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  It is the class for active object for making calls.

    37 *

    38 *  @lib phoneclient.lib

    39 *  @since 1.0

    40 */

    41 NONSHARABLE_CLASS( CPhCltExtPhone )

    42     : public CPhCltExtPhoneBase        

    43     {

    44     public:  // Constructors and destructor

    45         /**

    46         * Two-phased constructor.

    47         *

    48         * @param aObserver It is the observer for the instance.

    49         * @return Pointer to created CPhCltExtPhone instance.

    50         */

    51         static CPhCltExtPhone* NewL( MPhCltExtPhoneObserver* aObserver );

    52 

    53         /**

    54         * Destructor.

    55         */

    56         ~CPhCltExtPhone(); 

    57 

    58 

    59     public: // From baseclass

    60 

    61 

    62         /**

    63         * From CPhCltExtPhoneBase, Makes a new call.

    64         *

    65         * @param aData The populated dialing data.

    66         */

    67         virtual void DialL( CPhCltExtPhoneDialData& aData );

    68 

    69 

    70     private:

    71     

    72         /**

    73         * C++ constructor.

    74         */

    75         CPhCltExtPhone( MPhCltExtPhoneObserver* aObserver );

    76 

    77         /**

    78         * Symbian OS constructor.

    79         */

    80         void ConstructL();   

    81 

    82         /**

    83         * From CActive, it is called when object is active and 

    84         * request has been processed.

    85         */

    86         void RunL();

    87 

    88         /**

    89         * From CActive, calcels pending request.

    90         */

    91         void DoCancel();

    92 

    93         /**

    94         * Check that suitable preconditions have been satisified

    95         * before attempting a dial

    96         */

    97         void DialPreconditionCheckL();

    98 

    99 

   100     private:  // Data

   101 

   102         // Enumeration for the dialing operation modes.

   103         enum TMode 

   104             {

   105             EIdle,     // In idle state.

   106             EDialling  // In dialling state.

   107             };

   108         

   109         // Status information of the phone.

   110         // Not used. Just for BC.

   111         TPckgBuf< TInt > iPhoneStatus;

   112 

   113         // Call instance to perform dialing.

   114         RPhCltExtCall iCall;

   115         

   116         // Server that is used in dialing.

   117         RPhCltServer iServer;

   118 

   119         // Mode of the dialing operation.

   120         TMode iMode;

   121         

   122         /*

   123          * Package needs to member variable because it is possible that client

   124          * has high priority and in this case it is possible that package is deleted 

   125          * too early.

   126          */

   127         HBufC8* iPackage;

   128        

   129     };

   130 

   131 #endif      // CPHCLTEXTPHONE_H   

   132             

   133 // End of File