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

*/

 * Constructor method for the SSID query view object.

 * @param [in] parent pointer to parent object.

 * @return pointer to widget "occ_add_wlan_01".

    // It is not possible for this method to be called more than once during

    // wizard lifetime.

    Q_ASSERT(mWidget == NULL);

    bool ok;

    mLoader = new HbDocumentLoader(mWizard->mainWindow());

    mLoader->load(":/docml/occ_add_wlan_01_04.docml", &ok);

    Q_ASSERT(ok);

    // Load orientation

    loadDocmlSection(mWizard->mainWindow()->orientation());

    // Load widgets

    mWidget = qobject_cast<HbWidget*> (mLoader->findWidget(

        "occ_add_wlan_01"));

    Q_ASSERT(mWidget != NULL);

    mLabel = qobject_cast<HbLabel*> (mLoader->findWidget("dialog"));

    Q_ASSERT(mLabel != NULL);

    mSsid = qobject_cast<HbLineEdit*> (mLoader->findWidget("lineEditKey"));

    Q_ASSERT(mSsid != NULL);

    mLabel->setPlainText(hbTrId(

        "txt_occ_dialog_insert_the_name_of_the_new_wlan_net"));

    // Connect orientation signal from the main window to orientation

    // loader.

    ok = connect(mWizard->mainWindow(),

        SIGNAL(orientationChanged(Qt::Orientation)), this,

        SLOT(loadDocmlSection(Qt::Orientation)));

    Q_ASSERT(ok);

    // Connect text change-signal from input dialog to handler function

    ok = connect(mSsid, SIGNAL(textChanged(const QString &)), this,

        SLOT(textChanged(const QString &)));

    Q_ASSERT(ok);

    HbEditorInterface editInterface(mSsid);

    // TODO: remove (HbEditorConstraints) type cast when 

    // Q_DECLARE_OPERATORS_FOR_FLAGS(HbEditorConstraints) is defined (SDK xxx)

    editInterface.setInputConstraints(

        (HbEditorConstraints)(HbEditorConstraintAutoCompletingField |

            HbEditorConstraintLatinAlphabetOnly));

    editInterface.setSmileyTheme(HbSmileyTheme());

    editInterface.setEditorClass(HbInputEditorClassNetworkName);

    mSsid->setInputMethodHints(

        Qt::ImhNoPredictiveText | Qt::ImhPreferLowercase);

    mSsid->setMaxLength(WlanWizardUtils::SsidMaxLength);

	return mWidget;

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

 */

bool WlanWizardPageSsid::showPage()

{

    // Initiate the scanning of public APs here.

    mWizard->wlanQtUtils()->scanWlanAps();

    // Open virtual keyboard by setting focus to line edit

    mSsid->setFocus();

    return !(mSsid->text().isEmpty());

}

/*!

 * Stores the SSID selection in the configuration.

 * @param [out] removeFromStack returns false.

 * @return WlanWizardPageScanning page id.

    // SSID is stored into configuration

    mWizard->setConfiguration(WlanWizardPrivate::ConfSsid, mSsid->text());

    return WlanWizardPageInternal::PageScanning;

 * Loads the document orientation information from occ_add_wlan_01_04.docml

 * This is called each time phone orientation changes.

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

 * landscape mode.

void WlanWizardPageSsid::loadDocmlSection(Qt::Orientation orientation)

    WlanWizardPageInternal::loadDocmlSection(

        mLoader,

        orientation,

        ":/docml/occ_add_wlan_01_04.docml", 

        "portrait_section",

        "landscape_section");

 * Executed when changes have been made to the mSsid field (and the field is

 * not empty).

 * @param [in] text is not used at this point.

void WlanWizardPageSsid::textChanged(const QString &text)

    Q_UNUSED(text);

    OstTrace0( TRACE_FLOW, WLANWIZARDPAGESSID_TEXTCHANGED,

        "WlanWizardPageSsid::textChanged in text edit widget" );

    mWizard->enableNextButton(!(mSsid->text().isEmpty()));