1 /*

     2 * Copyright (c) 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: 

    15 *     See class description.

    16 *

    17 */

    18 

    19 #ifndef __MPHONEUISTATEMACHINEFACTORY_H

    20 #define __MPHONEUISTATEMACHINEFACTORY_H

    21 

    22 //  INCLUDES

    23 #include <e32std.h>

    24 

    25 

    26 // FORWARD DECLARATIONS

    27 

    28 class CPhoneUIController;

    29 class MPhoneStateMachine;

    30 class CPhoneResourceResolverBase;

    31 class CPhoneErrorMessagesHandler;

    32 

    33 class MPhoneViewCommandHandle;

    34 

    35 /**

    36 *  Class MPhoneUIStateMachineFactory : This abstract M-class defines the 

    37 *  interface for PhoneUiStateMachine factory. The interface provides the 

    38 *  abstraction of variant specific factory objects. The interface 

    39 *  consists of methods that can be used for creating instances of variant 

    40 *  specific classes.

    41 */

    42 class MPhoneUIStateMachineFactory

    43     {

    44     public:

    45         /**

    46         * Destructor

    47         */

    48         virtual ~MPhoneUIStateMachineFactory(){};

    49 

    50         /**

    51         * Creates an instance of CPhoneStateMachine

    52         * derived class using the loaded factory DLL. The user of this function

    53         * is responsible of the cleanup of the created object.

    54         * @return an instance of the class upcasted to CPhoneStateMachine

    55         */

    56         virtual MPhoneStateMachine* CreatePhoneStateMachineL(

    57             MPhoneViewCommandHandle* aViewCommandHandle ) = 0;

    58 

    59         /**

    60         * Creates an instance of CPhoneResourceResolverBase

    61         * derived class. The user of this function is responsible of cleanup of the created object.

    62         * @param None.

    63         * @return an instance of class upcasted to CPhoneResourceResolverBase class

    64         */

    65         virtual CPhoneResourceResolverBase* CreatePhoneResourceResolverL() = 0;

    66         

    67         /**

    68         * Creates an instance of CPhoneErrorMessagesHandler

    69         * derived class. The user of this function is responsible of cleanup of the created object.

    70         * @param None.

    71         * @return an instance of class upcasted to CPhoneErrorMessagesHandler class

    72         */

    73         virtual CPhoneErrorMessagesHandler* CreatePhoneErrorMessagesHandlerL(

    74             MPhoneViewCommandHandle* aViewCommandHandle,

    75             MPhoneStateMachine* aStateMachine ) = 0;

    76     };

    77 

    78 #endif      // __MPHONEUISTATEMACHINEFACTORY_H

    79     

    80 // End of File