/*

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

 *   WLAN Wizard Page: Security mode selection

 *

 */

/*

 * %version: 10 %

 */

#ifndef WLANWIZARDPAGESECURITYMODE_H

#define WLANWIZARDPAGESECURITYMODE_H

// System includes

// User includes

#include "wlanwizardpageinternal.h"

// Forward declarations

class HbRadioButtonList;

class HbLabel;

class WlanWizardPrivate;

class HbDocumentLoader;

// External data types

// Constants

/*!

 * @addtogroup group_wlan_wizard

 * @{

 */

class WlanWizardPageSecurityMode: public WlanWizardPageInternal

{

    Q_OBJECT

public:

    /*!

     * Constructor method for the Sequrity mode query view object.

     * @param parent pointer to parent object.

     */

    WlanWizardPageSecurityMode(WlanWizardPrivate* parent);

    /*!

     * Destructor for the Sequrity mode query view object.

     */

    ~WlanWizardPageSecurityMode();

    /*!

     * Page initialization procedures. Inherited from WlanWizardPage.

     * @see WlanWizardPage

     */

    HbWidget* initializePage();

    /*!

     * Validates the Sequrity more selection and sets the configuration in

     * the wlanwizard.

     * @param removeFromStack output parameter that returns false.

     * @return depending on the sequrity mode, returns the appropriate view

     * identifier.

     */

    int nextId(bool &removeFromStack) const;

    /*!

     * This method is overrides the default implementation from WlanWizardPage.

     * It indicates whether the Next-button should be enabled or not.

     * @return true, if a mode has been selected.

     */

    bool showPage();

private slots:

    /*!

     * Is invoked when user selects a mode from the radio button list.

     * (HbRadioButtonList's itemSelected-signal)

     * @param index of the selected item in the  radio button list. 

     */

    void itemSelected(int index);

    /*!

     * Loads the document orientation information from occ_add_wlan_02_03.docml

     * This is called each time phone orientation changes.

     * @param orientation indicates whether the phone is in portrait or

     * landscape mode.

     */

    void loadDocml(Qt::Orientation orientation);

private:

    /*!

     * Support function that creates the contents of the security mode list. 

     */

    void populateSecModeList();

    /*!

     * A support function to map the radio button list to a generic network

     * mode list. This enables the changing of button order without it

     * affecting the entire class.

     * @param list is a reference to a local list that will be placed as an

     * argument to the radio button list.

     * @param item is a reference to the text value that is appended to the

     * list

     * @param mode is the security mode associated with the item

     * @param page is the id of the next wizard page when this item is selected.

     * @param psk indicates whether password needs to be queried. 

     */

    void addToList(QStringList &list, const QString &item, int mode, int page,

        bool psk);

    /*!

     * Pointer to the view.

     */

    HbWidget *mWidget;

    /*!

     * Pointer to the radio button list object.

     */

    HbRadioButtonList *mList;

    /*!

     * Pointer to the label object.

     */

    HbLabel *mLabel;

    /*!

     * Pointer to document loader object.

     */

    HbDocumentLoader *mLoader;

    /*!

     * True, if a mode has been selected. False otherwise.

     */

    bool mValid;

    /*!

     * List of sequrity modes. This list is tied to the radio buttons during

     * the initialization of the page.

     */

    QList<int> mSecModes;

    /*!

     * List of page identifiers. This list is tied to the radio buttons during

     * the initialization of the page.

     */

    QList<int> mPageIds;

    /*!

     * List of password usage. This list is tied to the radio buttons during

     * the initialization of the page. True, if password is to be queried,

     * false otherwise

     */

    QList<bool> mUsePsk;

};

/*! @} */

#endif