/*
* Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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: Declares dialog. 
*
*/


#ifndef WEP_SECURITY_SETTINGS_DLG_H
#define WEP_SECURITY_SETTINGS_DLG_H


// INCLUDES
#include <eiklbo.h>
#include <AknDialog.h>
#include <aknlists.h>
#include <AknTabObserver.h>
#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
#include <commsdat.h>
#else
#include <commsdat.h>
#include <commsdat_partner.h>
#endif

#include "WepSecuritySettingsDefs.h"


// FORWARD DECLARATIONS
class CAknTitlePane;
class CAknNavigationControlContainer;
class CAknNavigationDecorator;
class CAknTabGroup;


// CLASS DECLARATION
/**
* CWEPSecuritySettingsDlg dialog class
*/
NONSHARABLE_CLASS( CWEPSecuritySettingsDlg ) : public CAknDialog, 
                                               public MEikListBoxObserver,
                                               public MAknTabObserver
    {

    public: // Constructors and destructor

        /**
        * Create and launch dialog.
        * @param aSecuritySettings Security settings
        * @param aTitle Title of the dialog
        * @return The ID of the button that closed the dialog
        */
        TInt ConstructAndRunLD( CWEPSecuritySettingsImpl* aSecuritySettings,
                                const TDesC& aTitle );


        /**
        * Two-phase construction.
        * @param aEventStore A reference to hold the events happened
        * @return The constructed CWEPSecuritySettingsDlg object.
        */
        static CWEPSecuritySettingsDlg* NewL( TInt& aEventStore );


        /**
        * Destructor.
        */
        ~CWEPSecuritySettingsDlg();


	protected:
        /**
        * Constructor.
        * @param aEventStore A reference to hold the events happened
        */
        CWEPSecuritySettingsDlg( TInt& aEventStore );


    public: // Functions from base classes
        /**
        * Handle key events. 
        * @param aKeyEvent: key event
        * @param aType: type of event
        * @return The key response, if it was consumed or not. 
        */
		TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent,
                                     TEventCode aType );


    public: // From MAknTabObserver

        /**
        * Called when a key is tab change happens.
        * @param aIndex index of the new tab
        */
        void TabChangedL( TInt aIndex ); 


	private:

        /**
        * This function is called by the dialog framework before the dialog is 
        * sized and laid out.
        */
        virtual void PreLayoutDynInitL();


        /**
        * Handles a dialog button press for the specified button 
        * @param aButtonId  The ID of the button that was activated.
        * @return   ETrue to validate and exit the dialog, 
        *           EFalse to keep the dialog active
        */
        TBool OkToExitL( TInt aButtonId );


		/**
        * Processes user commands.
        * @param aCommandId ID of the command to respond to. 
        */
		virtual void ProcessCommandL( TInt aCommandId );


		/**
        * Handles list box events.
        * @param aListBox   The originating list box. 
        * @param aEventType A code for the event.
        */
		void HandleListBoxEventL( CEikListBox* aListBox, 
                                  TListBoxEvent aEventType );

        /**
        * Get help context.
        * @param aContext Help context is returned here.
        */
        void GetHelpContext( TCoeHelpContext& aContext ) const;

        /**
        * Initialize menu pane.
        * @param aResourceId Menu pane resource id.
        * @param CEikMenuPane Menu pane.
        */
        void DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane );


    protected:  // New functions

        /**
        * Handles listbox data change
        */
        void HandleListboxDataChangeL();


        /**
        * Fills up the listbox with data
        * @param aItemArray Array where to add the elements
        * @param arr        Array to be used as list elements
        * @param aLength    The number of elements in the above array
        * @param aRes       Array of resource IDs to be used for the 
        *                   elements of arr
        */
        void FillListWithDataL( CDesCArrayFlat& aItemArray, 
                                const CWEPSecuritySettings::TWepMember& arr, 
                                TInt aLength,
                                const TInt* aRes );


        /**
        * Updates one listbox item for the given member
        * @param aMember    Value specifying which member has to be added to 
        *                   the list
        * @param aRes       Resource ID for the 'title text' for this member
        * @param aPos       The current position of the item in the list
        */
        void UpdateListBoxItemL( CWEPSecuritySettings::TWepMember aMember, 
                                 TInt aRes, TInt aPos );


        /**
        * Creates one 'textual' listbox item for the given member
        * @param aMember    Value specifying which member has to be added to
        *                   the list
        * @param aRes       Resource ID for the 'title text' for this member
        * @return The created listbox item text.
        */
        HBufC* CreateTextualListBoxItemL( CWEPSecuritySettings::TWepMember aMember, 
                                          TInt aRes );


        /**
        * Changes one setting. The setting, which is
        * highlighted as current in the listbox is changed.
        * @param aQuick ETrue if the setting is "two-choices", and can be 
        *               automatically changed, without showing the list of 
        *               elements
        */
        void ChangeSettingsL( TBool aQuick );


        /**
        * Shows a popup setting page (radio buttons) for the given member
        * @param aDataMember    The member which needs to be changed
        * @return   A boolean indicating whether the current setting
        *           has been changed or not.
        */
        TBool   ShowPopupSettingPageL( 
                                CWEPSecuritySettings::TWepMember aDataMember );


        /**
        * Shows a popup text setting page for the given member
        * @return   A boolean indicating whether the current setting
        *           has been changed or not.
        */
        TBool ShowPopupTextSettingPageL();


        /**
        * Fills up a pop-up radio button setting page with the currently
        * valid and available choices for the given member.
        * @param aData      The member whose new setting is needed
        * @param aCurrvalue The current value of the setting
        * @return   An array of choices for the given member, pushed to the 
        *           CleanupStack.
        */
        CDesCArrayFlat* FillPopupSettingPageLC( 
                                        CWEPSecuritySettings::TWepMember aData,
                                        TInt& aCurrvalue );


        /**
        * Updates the given member's data with the new setting from the setting
        * page.
        * @param aData      The member to update
        * @param aCurrvalue The new value
        * @return   A boolean indicating if the value is actually changed
        */
        TBool UpdateFromPopupSettingPage( CWEPSecuritySettings::TWepMember aData, 
                                          TInt aCurrvalue );


        /**
        * Inverts one boolean member 
        * @param aDataMember the member to invert.
        */
        void InvertSettings( CWEPSecuritySettings::TWepMember aDataMember );


    private: //data

        // Stores the name of the connection, to be showed as the title.
      	TBuf<CommsDat::KMaxTextLength> iConnectionName;

        // Title pane. Not owned.
        CAknTitlePane* iTitlePane;

        // Pointer to the old title. Owned.
        HBufC* iOldTitleText;

        // Empty Navigation decorator. Owned.
        CAknNavigationDecorator* iNaviDecoratorEmpty;

        // Tabbed Navigation decorator. Owned.
        CAknNavigationDecorator* iNaviDecoratorTabbed;

        // Navi Pane. Not owned.
        CAknNavigationControlContainer* iNaviPane;

        // Tab Group. Not owned.
        CAknTabGroup* iTabGroup;

        // Index of the active tab
        TInt iActiveTab;

        // Owned through resources, destroyed automatically by the dialog.
        CAknSettingStyleListBox* iList;

        // Array of the items. Not owned.
        CDesCArrayFlat* iItemArray;

        // Fields of the main view. Not owned.
        CWEPSecuritySettings::TWepMember* iFieldsMain;

        // Titles of the main view. Not owned.
        TInt* iTitlesMain;

        // Fields of the key configuration view. Not owned.
        CWEPSecuritySettings::TWepMember* iFieldsKeyConfiguration;

        // Titles of the key configuration view. Not owned.
        TInt* iTitlesKeyConfiguration;

        // Pointer to the WEP Security Settings. Not owned.
        CWEPSecuritySettingsImpl* iSecuritySettings;

        // current level (main or key configuration)
        TInt iLevel;

        // To hold the events. Not owned.
        TInt* iEventStore;
    };


#endif      // WEP_SECURITY_SETTINGS_DLG_H

// End of File
