/*

* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:

*

*/

#ifndef SATAPPEVENTPROVIDER_H

#define SATAPPEVENTPROVIDER_H

#include <QObject>

#include <msatuiobserver.h>

#include "msatuiactionimplementer.h"

class CSatUiObserver;

class SatAppEventProvider: public QObject,

                           public MSatUiActionImplementer

{

    Q_OBJECT

public:

    /**

    * Constructor

    */

    SatAppEventProvider(QObject *parent = 0);

    /**

    * Distructor

    */

    virtual ~SatAppEventProvider();

signals:

     /**

     * Notification of the SAT Display Text command.

     * @param aRes, the User's response.

     * @param aText The text string to be displayed.

     * @param aSimApplicationName  Sim Application name

     * @param aIcon the icon to show.

     * @param aRequestedIconDisplayed Informs if icon is not used.

     * @param aSustainedText Indicates is this text sustained ie. no timers

     *        used if true.

     * @param aDuration Duration for showing the text

     * @param aWaitUserToClear Indication if user is needed to clear

     *        message

     */

    void displayTextEvent(

        TSatUiResponse &aRes,

        const QString &aText,

        const QString &aSimApplicationName,

        bool &aRequestedIconDisplayed,

        const bool aSustainedText,

        const int aDuration,

        const bool aWaitUserToClear);

    /**

     * Notification of the SAT Get Input command.

     * @param aText The query text.

     * @param aCharacterSet The character range allowed.

     * @param aInput The input string.

     * @param aMaxLength The maximum length of the input allowed.

     * @param aMinLength The minimum length of the input allowed.

     * @param aHideInput A flag indicating if the input should be hidden.

     * @param aHelpIsAvailable indicates if help can be requested.

     * @param aIconId The id of icon.

     * @param aRequestedIconDisplayed Informs if icon is not used.

     * @return The response of the UI to this command.

     */

    void getInputEvent(

        TSatUiResponse &aRes,

        const QString &aTitleText,

        const TSatCharacterSet aCharacterSet,

        QString &aInputText,

        const int aMinLength,

        const int aMaxLength,

        const bool aHideInput,

        const bool aSelfExplanatory,

    /**

     * Notification of the SAT Get Inkey command.

     * @param aText The query text.

     * @param aCharacterSet The character range allowed.

     * @param aInput The input string.

     * @param aHideInput A flag indicating if the input should be hidden.

     * @param aHelpIsAvailable indicates if help can be requested.

     * @param aIconId The id of icon.

     * @param aRequestedIconDisplayed Informs if icon is not used.

     */

    void getInkeyEvent(

        TSatUiResponse &aRes,

        const QString &aTitleText,

        const TSatCharacterSet aCharacterSet,

        QString &aInputText,

        const bool aSelfExplanatory,

    /**

     * Notification of the SAT Get YesNo command.

     * @param aText The query text.

     * @param aCharacterSet The character range allowed.

     * @param aInput The input character.

     * @param aHelpIsAvailable indicates if help can be requested.

     * @param aIconId The id of icon.

     * @param aRequestedIconDisplayed Informs if icon is not used.

     * @param aDuration Duration for showing the dialog.

     * @param aImmediateDigitResponse Indication if Immediate digit response

     *        is needed.

     * @return The response of the UI to this command.

     */

    void getYesNoEvent(

        TSatUiResponse &aRes,

        const QString &aText,

        const TSatCharacterSet aCharacterSet,

        unsigned int &aInkey,

        //const TSatIconId &aIconId,

        const bool &aSelfExplanatory,

        unsigned int &aDuration,

    /**

    * Handles the SetUpMenu command.

    * @param aRes the out parameter. the result of the command.

    * @param aText The title text.

    * @param aMenuItems The array of menu item captions.

    * @param aMenuItemNextActions The array of menu item next action

    * indicator captions.

    * @param aIconBitmap The Context pane icon.

    * @param aItemsIconArray Array of item icons

    * @param aSelfExplanatoryItems A flag indicating if only icons are shown.

    * @param aHelpIsAvailable A flag indicating if SAT help is available.

    */

    void setUpMenuEvent(

        TSatUiResponse &aRes,

        const QString &aText,

        const QStringList &aMenuItems,

        const bool aSelfExplanatoryItems,

        const bool aHelpIsAvailable);

    /**

    * Handles the SelectItem view.

    * @param aRes the out parameter. the result of the command.

    * @param aText The title text.

    * @param aMenuItems The array of menu items.

    * @param aMenuItemNextActions The array of next action indicators.

    * @param aDefaultItem The item in focus.

    * @param aSelection The item index selected by the user.

    * @param aIconBitmap The Context Pane icon.

    * @param aItemsIconArray Array of item icons

    * @param aSelfExplanatoryItems Flag indicating if only icons are shown.

    * @param aHelpIsAvailable A flag indicating if SAT help is available.

    * @return Information of the operation result.

    */

    void selectItemEvent(

        TSatUiResponse &aRes,

        const QString &aText,

        const QStringList &aMenuItems,

        const int aDefaultItem,

        unsigned char &aSelection,

        const bool aSelfExplanatoryItems,

        const bool aHelpIsAvailable);

    /**

    * Shows the confirmation note about the SAT Send SMS, Send SS or

    * Send USSD command.

    * @param aText The text to be displayed.

    * @param aActionAccepted Indicates whether the command was accepted.

    * @param aType Type of the request (SMS, SS, USSD).

    * @return Information of the operation result.

    */

    void confirmSendEvent(

        TSatUiResponse &aRes,

        const QString &aText,

        bool &aActionAccepted,

        int aType);

     /**

     * Shows the wait note about the Send SMS command.

     * @param aText The text to be displayed.

     * @param aIconBitmapSendSM Sending dialog icon.

     * @param aSelfExplanatoryIcon A flag indicating if only icon is shown.

     */

    void showSmsWaitNoteEvent(

        const QString &aText,

    /**

    * Shows the confirmation not about SetUpCall.

    * @param aText The text to be displayed.

    * @param aSimAppName The header to be displayed.

    * @param aActionAccepted Indicates whether the command was accepted.

    */

   void showSetUpCallConfirmEvent(

        const QString &aText,

        const QString &aSimAppName,

     /**

     * Shows the wait note about the Send DTMF command.

     * @param aText The text to be displayed.

     * @param aIconBitmapSendSM Sending dialog icon.

     */

    void showDtmfWaitNoteEvent(

        TSatUiResponse &aRes,

        const QString &aText);

     * @param aText The text to be displayed.

     */

     */

    /*!

     Removes Display Text Dialog from the screen.

    */

    void clearScreenEvent();

    /*!

     Close the sat ui

     */

    void closeUiEvent();

    /*!

    *Close wait note

    */

    void stopShowWaitNoteEvent();

public slots:

    /*!

    */

public: // from MSatUiActionImplementer and impletment by QT

    /**

    * Shows the wait note.

    */

    virtual void ShowWaitNoteL() {};

    /**

    * Shows the wait note without delay

    */

    /**

    * Removes the wait note from the screen.

    */

    void StopShowWaitNote();

    /**

     * Handles the SetUpMenu view.

     * @param aText The title text.

     * @param aMenuItems The array of menu item captions.

     * @param aMenuItemNextActions The array of menu item next action

     * indicator captions.

     * @param aIconBitmap The Context pane icon.

     * @param aItemsIconArray Array of item icons

     * @param aSelfExplanatoryItems Flag indicating if only icons are shown.

     * @param aHelpIsAvailable A flag indicating if SAT help is available.

     * @return Information of the operation result.

     */

     virtual TSatUiResponse SetUpMenuL(

         const TDesC &aText,

         const MDesCArray &aMenuItems,

         const CArrayFixFlat<TSatAction>* aMenuItemNextActions,

         const TBool aSelfExplanatoryItems,

         const TBool aHelpIsAvailable);

    /**

     * Handles the SelectItem view.

     * @param aText The title text.

     * @param aMenuItems The array of menu items.

     * @param aMenuItemNextActions The array of next action indicators.

     * @param aDefaultItem The item in focus.

     * @param aSelection The item index selected by the user.

     * @param aIconBitmap The Context Pane icon.

     * @param aItemsIconArray Array of item icons

     * @param aSelfExplanatoryItems Flag indicating if only icons are shown.

     * @param aHelpIsAvailable A flag indicating if SAT help is available.

     * @return Information of the operation result.

     */

         const MDesCArray &aMenuItems,

         const CArrayFixFlat<TSatAction>* aMenuItemNextActions,

         const TInt aDefaultItem,

         TUint8 &aSelection,

         const TBool aSelfExplanatoryItems,

    /**

    * Returns CoeEnv.

    */

    virtual CCoeEnv* CoeEnv() { return 0; };

    /**

    * Handles the DisplayText operation.

    * @param aText Text to be shown.

    * @param aSimApplicationName  Sim Application name

    * @param aIconBitmapDisplayText Icon for dialog

    * @param aSustainedText Indicates is this text sustained ie. no timers

    *        used if ETrue.

    * @param aDuration Duration for showing the text

    * @param aWaitUserToClear Indication if user is needed to clear

    *        message

    * @return Information of the operation result.

    */

    virtual TSatUiResponse DisplayTextL(

        const TDesC &aText,

        const TDesC &aSimApplicationName,

        const TBool aSelfExplanatoryIcon,

        const TBool aSustainedText,

        const TTimeIntervalSeconds aDuration,

        const TBool aWaitUserToClear);

    /**

    * Removes Display Text Dialog from the screen.

    */

    virtual void ClearScreen();

    /**

    * Asks a Yes/No answer from the user.

    * @param aText A question to be shown.

    * @param aCharacterSet The character range allowed.

    * @param aInkey Character user feeds.

    * @param aIconBitmap Icon for query dialog.

    * @param aSelfExplanatory Flag indicating if icon is self-explanatory.

    * @param aDuration Duration for showing the dialog.

    * @param aImmediateDigitResponse Indication if Immediate digit response

    *        is needed.

    * @return Information of the operation result.

    */

    virtual TSatUiResponse GetYesNoL(

        const TDesC &aText,

        const TSatCharacterSet aCharacterSet,

        TChar &aInkey,

        const TBool aSelfExplanatory,

        TUint &aDuration,

        const TBool aImmediateDigitResponse);

    /**

    * Asks input from the user.

    * @param aText A question to be shown.

    * @param aCharacterSet The character range allowed.

    * @param aInput The input string.

    * @param aMinLength The minimum length of the input allowed.

    * @param aMaxLength The maximum length of the input allowed.

    * @param aHideInput A flag indicating if the input should be hidden.

    * @param aGetInkey A flag indicating if GetInkey command is used.

    * @param aIconBitmapGetInput Icon for query dialog.

    * @param aSelfExplanatory  A flag indicating if icon is self-explanatory.

    * @param aDuration Duration for showing the dialog.

    * @return Information of the operation result.

    */

    virtual TSatUiResponse GetInputL(

        const TDesC &aText,

        const TSatCharacterSet aCharacterSet,

        TDes &aInput,

        const TInt aMinLength,

        const TInt aMaxLength,

        const TBool aHideInput,

        const TBool aGetInkey,

        const TBool aSelfExplanatory,

    /**

    * Handles Standard Tone playing.

    * @param aText The text to be displayed.

    * @param aFileName The name of the file corresponding to the tone.

    * @param aDuration The duration of the tone to be played.

    * @param aIconBitmap The tone playing note icon

    * @param aSelfExplanatory Flag indicating if icon is self-explanatory.

    * @return Information of the operation result.

    */

    virtual TSatUiResponse PlayStandardToneL(

    /**

    * Shows the confirmation note about the SAT Send SMS, Send SS or

    * Send USSD command.

    * @param aText The text to be displayed.

    * @param aActionAccepted Indicates whether the command was accepted.

    * @param aType Type of the request (SMS, SS, USSD).

    * @return Information of the operation result.

    */

    virtual TSatUiResponse ConfirmSendL(

        const TDesC &aText,

        TBool &aActionAccepted,

        TInt aType);

    /**

    * Shows the wait note about the Send SMS command.

    * @param aText The text to be displayed.

    * @param aIconBitmapSendSM Sending dialog icon.

    * @param aSelfExplanatoryIcon A flag indicating if only icon is shown.

    */

    virtual void ShowSmsWaitNoteL(

        const TDesC &aText,

        const TBool aSelfExplanatoryIcon);

    /**

    * Shows the wait note about the Send SS command.

    * @param aText The text to be displayed.

    * @param aIconBitmap Sending dialog icon.

    * @param aSelfExplanatoryIcon A flag indicating if only icon is shown.

    */

    virtual void ShowSsWaitNoteL(

    /**

    * Shows the confirmation note about the SAT Refresh command.

    * @param aActionAccepted Indicates whether the command was accepted.

    * @return Information of the operation result.

    */

    virtual TSatUiResponse ConfirmRefreshL(

            TBool &/*aActionAccepted*/)

        {

            return ESatSuccess;

        };

    /**

    * Notification of the SAT Call Control command.

    * @param aText The text string to be displayed.

    * @param aAlphaIdStatus Alpha Identifier status

    * @param aControlResult Call control general result

    * @return The response from the UI

    */

    virtual TSatUiResponse CallControlL(

    /**

    * Notification of the SAT Launch browser confirmation request

    * @param aText The text to be displayed.

    * @param aActionAccepted Indicates whether the command was accepted.

    * @param aIconBitmap The confirm note icon

    * @param aSelfExplanatory Flag indicating if icon is self-explanatory.

    */

    virtual void ConfirmLaunchBrowserL(

        const TDesC &/*aText*/,

        TBool &/*aActionAccepted*/,