wlanutilities/wlanwizard/inc/wlanwizardpagessid.h
changeset 31 e8f4211554fb
child 39 7b3e49e4608a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/wlanutilities/wlanwizard/inc/wlanwizardpagessid.h	Mon May 24 21:11:39 2010 +0300
@@ -0,0 +1,141 @@
+/*
+ * 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