1 /*

     2 * Copyright (c) 2002-2005 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:  Declaration of CPhoneHandlerActive class.

    15 *

    16 */

    17 

    18 

    19 #ifndef CPHONEHANDLERACTIVE_H

    20 #define CPHONEHANDLERACTIVE_H

    21 

    22 //  INCLUDES

    23 #include <e32base.h>

    24 

    25 // CONSTANTS

    26 

    27 // MACROS

    28 

    29 // DATA TYPES

    30 

    31 // FUNCTION PROTOTYPES

    32 

    33 // FORWARD DECLARATIONS

    34 class MPhoneHandlerObserver;

    35 

    36 // CLASS DECLARATION

    37 

    38 /**

    39 *  Active object used to call asynchronous requests.

    40 *

    41 *  @lib PhoneCmdHandler

    42 *  @since S60 3.1

    43 */

    44 NONSHARABLE_CLASS( CPhoneHandlerActive ) : public CActive

    45     {

    46     public: // Constructors and destructor

    47     

    48         /**

    49         * Two-phased constructor.

    50         */

    51         static CPhoneHandlerActive* NewL( MPhoneHandlerObserver& aObserver );

    52     

    53         /**

    54         * Destructor.

    55         */

    56         ~CPhoneHandlerActive();

    57     

    58     public: // New functions

    59     

    60         /**

    61         * From CActive. Indicates that the active object has issued a request 

    62         * and that it is now outstanding.  

    63         * @since S60 3.1

    64         * @return 

    65         */

    66         void SetActive();

    67         

    68     public: // Functions from base classes

    69         

    70     protected:  // New functions

    71     

    72     protected:  // Functions from base classes

    73     

    74         /**

    75         * From CActive. Handles an active object’s request completion event.

    76         */

    77         void RunL();

    78     

    79         /**

    80         * From CActive. Implements cancellation of an outstanding request.

    81         */

    82         void DoCancel();

    83     

    84         /**

    85         * From CActive. Handles a leave occurring in the request completion 

    86         * event handler RunL().

    87         */

    88         TInt RunError( TInt aError );

    89 

    90     private:

    91         

    92         /**

    93         * C++ default constructor.

    94         */

    95         CPhoneHandlerActive( MPhoneHandlerObserver& aObserver );

    96     

    97         /**

    98         * By default Symbian 2nd phase constructor is private.

    99         */

   100         void ConstructL();

   101     

   102     public:     // Data

   103     

   104     protected:  // Data

   105     

   106     private:    // Data

   107         

   108         // Notifies caller of an asynchronous request when request has been 

   109         // completed.  

   110         MPhoneHandlerObserver& iObserver;

   111         

   112     public:     // Friend classes

   113 

   114     protected:  // Friend classes

   115 

   116     private:    // Friend classes

   117     };

   118 

   119 #endif // CPHONEHANDLERACTIVE_H

   120 

   121 // End of File