/*

* 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. 

*

*/

/*

* %version: tr1cfwln#14 %

*/

#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