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:    See class definition below.

    15 *

    16 */

    17 

    18 

    19 

    20 

    21 

    22 #ifndef __MMCETESTUIUSERINTERFACE_H

    23 #define __MMCETESTUIUSERINTERFACE_H

    24 

    25 #include "CMCETestUIQuestionSingleSelection.h"

    26 #include "CMCETestUIQuestionDataQuery.h"

    27 #include "CMCETestUIEngine.h"

    28 

    29 

    30 /**

    31 * 

    32 * Interface description: 

    33 *

    34 * Class defines interface to communicate between UI and UI engine.

    35 *

    36 */

    37 class MMCETestUIUserInterface

    38     {

    39     

    40     public: // Functions to give information to user

    41 

    42 	    /**

    43 	    * Informs user interface that internal state of engine has changed. 

    44 	    */       

    45 	    virtual void EngineStateChangedL() = 0;

    46 	    

    47 	     

    48 	    /**

    49 	    * Notifies user. 

    50 	    * @param aMessage notification to be shown to user

    51 	    */     

    52         virtual void NotifyUser( const TDesC& aMessage ) = 0;

    53         

    54 	    /**

    55 	    * Notifies user. The note has to be dismissed by the user.

    56 	    * @param aMessage notification to be shown to user

    57 	    */     

    58         virtual void NotifyUserWaitL( const TDesC& aMessage ) = 0;

    59 

    60         /////////////////////////////////////// 

    61         //

    62         // TODO: Functions to inform and warn user 

    63         //

    64         ////////////////////////////////////////

    65         

    66     public: // Functions to retrieve information from user

    67         

    68         /**

    69         * Asks user to select one of multiple choices.

    70         * 

    71         * @param aQuestion data structure holding the question and choices.

    72         * @return index of chosen choice. Negative if canceled or otherwise not

    73         *         answered. 

    74         */ 

    75         virtual TInt AskQuestionL( 

    76                 const CMCETestUIQuestionSingleSelection& aQuestion ) = 0;

    77                 

    78         /**

    79         * Asks user to input single textual value

    80         * 

    81         * @param aQuestion data structure holding the question,

    82         *                  default value and answering function.

    83         */                 

    84         virtual void AskQuestionL( CMCETestUIQuestionDataQuery& aQuestion ) = 0;

    85         

    86         virtual TBool SessionParamsL(TSessionParams& aSessionParams, TSessionType aSessionType) = 0;

    87         				

    88         virtual TBool SessionEstablishValues(TSessionEstablishValues &sessionValues) = 0;

    89         

    90         virtual TBool SessionResponseValues(TSessionResponseValues &responseValues) = 0;

    91         

    92         virtual TBool NotifyValues(TNotifyValues &responseValues) = 0;

    93         				

    94         virtual TBool EventParamsL(TEventParams& aEventParams) = 0;

    95         

    96         virtual TBool ReferParamsL(TReferParams& aReferParams) = 0;

    97         

    98         virtual TBool ReferToParamsL(TReferParams& aReferParams) = 0;

    99         

   100         virtual void ChangeToMainViewL() = 0;

   101         

   102         virtual void CreateMceSettingsL() = 0;

   103         

   104         virtual void CreateMceValueSettingsL() = 0;

   105         

   106         virtual TBool IsVideoEnabled() = 0;

   107         

   108         virtual void EnableVideo() = 0;

   109         

   110         virtual void DisableVideo() = 0;

   111         

   112         virtual TBool StartDTMFToneL( TChar& aChar ) = 0;

   113         

   114         virtual TBool SendDTMFToneL( TChar& aChar, TInt& aInterval ) = 0;

   115         

   116         virtual TBool SendDTMFToneSequenceL( TDes& aSequence  ) = 0;

   117         

   118         virtual TBool GetIapIdL( TInt& aIapId  ) = 0;

   119         

   120         virtual TBool GetCodecTypeL( TInt& aCodecIndex  ) = 0;

   121         

   122         virtual void ShowCurrentCryptoContextsL(TBool aCrypto32,TBool aCrypto80) = 0;

   123         

   124         virtual void ShowSupportedCryptoContextsL(TBool aCrypto32,TBool aCrypto80) = 0;

   125         

   126         virtual void GetCryptoContextsL(TBool& aCrypto32,TBool& aCrypto80) = 0;

   127         

   128         virtual TRect GetRect() = 0;

   129 

   130     };

   131     

   132 #endif	// __MMCETESTUIUSERINTERFACE_H

   133