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