/*
 * 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: Ssid query
 *
 */

#ifndef WLANWIZARDPAGESSID_H
#define WLANWIZARDPAGESSID_H

// System includes

// User includes
#include "wlanwizardpageinternal.h"
#include "wlanwizardutils.h"

// Forward declarations
class WlanWizardPrivate;
class HbLabel;
class HbLineEdit;
class HbDocumentLoader;
class TestWlanWizardUi;

// External data types

// Constants

/*!
 * @addtogroup group_wlan_wizard
 * @{
 */

class WlanWizardPageSsid: public WlanWizardPageInternal
{
    Q_OBJECT
    friend class TestWlanWizardUi;
public:
    /*!
     * Constructor method for the SSID query view object.
     * @param parent pointer to parent object.
     */
    WlanWizardPageSsid(WlanWizardPrivate* parent);
    
    /*!
     * Destructor for the SSID query view object.
     */
    ~WlanWizardPageSsid();

    /*!
     * Page initialization procedures. Inherited from WlanWizardPage.
     */
    HbWidget* initializePage();
    
    /*!
     * This method is overrides the default implementation from WlanWizardPage.
     * It indicates whether the Next-button should be enabled or not.
     * @return true, if mSsid edit field is not empty.
     */
    virtual bool showPage();

    /*!
     * Validates the SSID selection and sets the configuration in
     * the wlanwizard.
     * @param removeFromStack output parameter that returns false.
     * @return WlanWizardPageScanning page id.
     */
    int nextId(bool &removeFromStack) const;
   
public slots:
    /*!
     * Loads the document orientation information from occ_add_wlan_01_04.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);
    
    /*!
     * Executed when changes have been made to the mSsid field.
     * @param text is not used at this point.
     */
    void textChanged(const QString &text);
    
protected:
    /*!
     * Reimplements QObject function that is invoked on any event. This
     * function handles only a focus event to mSsid edit field.
     * @param obj contains the object, where the event originates from.
     * @param event contains the event id.
     */
    bool eventFilter(QObject *obj, QEvent *event);
    
private:
    /*!
     * Converts status identifier to plain-text QString format.
     * @param status indicates SSID status code.
     * @return status text.
     */
    QString SsidStatusToErrorString(WlanWizardUtils::SsidStatus status) const;
    
private:
    /*!
     * Pointer to the view.
     */
    HbWidget *mWidget;
    
    /*!
     * Pointer to the header label object.
     */
    HbLabel *mLabel;
    
    /*!
     * Pointer to the line edit object.
     */
    HbLineEdit *mSsid;
    
    /*!
     * Pointer to error label object.
     */
    HbLabel *mLabelError;
    
    /*!
     * Pointer to the document loader object.
     */
    HbDocumentLoader *mLoader;
};

/*! @} */

#endif