/*

* Copyright (c) 2007-2008 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:  Class header for CWsfAiHelperAppUi

*

*/

#ifndef C_WSFAIHELPERAPPUI_H

#define C_WSFAIHELPERAPPUI_H

//  EXTERNAL INCLUDES

#include <aknViewAppUi.h>

#include <AknWaitDialog.h>

//  INTERNAL INCLUDES

#include "wsfmodelobserver.h"

#include "wsfstatechangeobserver.h"

//  FORWARD DECLARATIONS

class TWsfWlanInfo;

class CWsfAiHelperDocument;

//  CLASS DEFINITION

/**

 * An instance of class CWsfApHelperAppUi is the UserInterface part of 

 * the AVKON application framework

 * 

 * @since S60 5.0

 * @lib wsfaihelper.exe

 */

NONSHARABLE_CLASS( CWsfAiHelperAppUi ): public CAknViewAppUi,    

                                        public MWsfModelObserver, 

                                        public MWsfStateChangeObserver

    {

    public:

        /**

         * Second-phase constructor.

         * @since S60 5.0

         */

        void ConstructL();

        /**

         * Constructor

         * @since S60 5.0

         */

         CWsfAiHelperAppUi();

         /**

          * Destructor

          * @since S60 5.0

          */

        ~CWsfAiHelperAppUi();

    public: // from CAknAppUi

        /**

         * Handle user menu selections

         * @since S60 5.0

         * @param aCommand The enumerated code for the option selected

         */

        void HandleCommandL( TInt aCommand );

        /**

         * Processes shell commands.

         * @since S60 5.0

         * @param aCommand The shell command sent to the application

         * @param aDocumentName The name of the document as specified on 

         *                      the command line.

         * @param aTail Command line tail

         * @return Whether the final value of aDocumentName represents 

         *         an existing file

         */ 

        TBool ProcessCommandParametersL( TApaCommand aCommand,

                                         TFileName& aDocumentName,

                                         const TDesC8& aTail );

    public:     // new methods

        /**

         * Returns the handle of application document instance

         * @since S60 5.0

         * @return Pointer to the document. Ownership not passed.

         */ 

        CWsfAiHelperDocument* Doc();

        /**

        * Called when the filename to be opened has been resolved

        * @since S60 5.0

        */

        void NotifyFileName();

        /**

        * Sends Helper To Background

        * @since S60 5.2

        */

        void SendHelperToBackground();

    public: // from MWsfModelObserver

        /**

         * Called if the launch has been completed successfully

         * @since S60 5.0 

         */

        void BrowserLaunchCompleteL();

        /**

         * Called if the browser launch failed for some reason

         * @since S60 5.0 

         * @param aError error code

         */

        void BrowserLaunchFailed( TInt aError );

        /**

        * Called when the previously launched browser exits

        * @since S60 5.0

        */

        void BrowserExitL();

        /**

        * Notification that connection is going to be created

        * @since S60 5.0

        * @param aIapId The IAP id of the connection being created

        */

        void ConnectingL( TUint32 aIapId );

        /**

        * Notification that the connection creation process ended

        * @since S60 5.0

        * @param aResult The result of the connection creation

        */

        void ConnectingFinishedL( TInt aResult );

    public:     // from MWsfStateChangeObserver

        /**

        * The current wlan data has changed and it is ready to be retrieved

        * @since S60 5.0

        */

        void WlanListChangedL();

        /**

        * Engine error occured

        * @since S60 5.0

        * @param aError System wide error code

        */

        void NotifyEngineError( TInt aError );

        /**

        * Scanning has been disabled

        * @since S60 5.0

        */

        void ScanDisabledL();

        /**

        * Scanning has been enabled

        * @since S60 5.0

        */

        void ScanEnabledL();

        /**

        * A WLAN connection has been established

        * @since S60 5.0

        * @param aAccesspointName The name of the active connection

        */

        void WlanConnectionActivatedL( const TDesC& aAccessPointName );

        /**

        * A WLAN connection has been closed

        * @since S60 5.0

        */

        void WlanConnectionClosedL();   

        /**

        * Connection creation process finished

        * @since S60 5.2

        * @param aError System wide error code

        */

        void ConnectionCreationProcessFinishedL( TInt aError );

    private:    // new methods

        /**

         * Called when application launch has been completed

         * @since S60 5.0

         * @param aObject Pointer to this object

         * @return Zero value means not be called again.(Stops timer)

         */

        static TInt LaunchCompletedL( TAny* aObject );

        /**

        * Cleanup function to release the key events suppressing

        * @since S60 5.0

        * @param aPtr Pointer for this class

        */

        static void ReleaseSuppressingKeyEventsL( TAny* aPtr );

    private:    // data

        /**

         * Used to begin accesspoint creation when app launching has completed

         * (owned)

         */ 

        CIdle* iIdle;

        /**

         * Indicates whether keypress events are suppressed

         */

        TBool iSuppressingKeyEvents;

        /**

         * IAP creation return value

         */

        TInt iResult;

    };

#endif // C_WSFAIHELPERAPPUI_H