diff -r 63be7eb3fc78 -r f28ada11abbf wlanutilities/wlanwizard/src/wlanwizard.cpp --- a/wlanutilities/wlanwizard/src/wlanwizard.cpp Tue Aug 31 16:18:40 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,172 +0,0 @@ -/* -* 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: API. -*/ - -// System includes - -// User includes -#include "wlanwizard.h" -#include "wlanwizard_p.h" - -/*! - \class WlanWizard - \brief Interface of WLAN Wizard. - - Example usage: - \code - MyClass::createWizard() { - mWizard = new WlanWizard(mainWindow()); - connect( - mWizard, - SIGNAL(finished(int, bool)), - this, - SLOT(finished(int, bool))); - connect(mWizard, SIGNAL(cancelled()), this, SLOT(cancelled())); - - // If client know the parameters for WLAN Access Point call following - mWizard->setParameters( - "MySSid", - CmManagerShim::Infra, - CmManagerShim::WlanSecModeWpa, - true, // WPA-PSK - false); // Non-Wifi Protected Setup - - // and execute wizard - mWizard->show(); - } - - void MyClass::finished(int iapId, bool connected) { - // User has successfully created WLAN IAP with the wizard. - - // if connected equals to true, wizard has established connection to it - // now the client needs to connect also to given IAP Id to keep the - // connection open. - // see WlanQtUtils or RConnection. - - // Delete wizard. Do not delete in this call stack since this call has - // been done from the context of the wizards call stack. - mWizard->deleteLater(); - mWizard = NULL; - } - - void MyClass::cancelled() { - // wizard operation was cancelled by user, iap has not been created - // and WLAN connection is not established - - // Delete wizard. Do not delete in this call stack since this call has - // been done from the context of the wizards call stack. - mWizard->deleteLater(); - mWizard = NULL; - } - \endcode - - Implements wizard based on wizard pattern. - */ - -/*! - \fn void WlanWizard::cancelled() - This signal is emitted when the execution of wizard has been cancelled. - */ - -/*! - \fn void WlanWizard::finished(int iapId, bool connected) - This signal is emitted when the execution of wizard has been finished - succesfully. - - @param iapId IAP ID that has been created. - @param connected true if the connection to wlan has been established. - */ - -// External function prototypes - -// Local constants - - -// ======== LOCAL FUNCTIONS ======== - -// ======== MEMBER FUNCTIONS ======== - -/*! - Constructor of WLAN Wizard. - - @param [in] mainWindow HbMainWindow to where the wizard is going to be executed. - */ -WlanWizard::WlanWizard(HbMainWindow *mainWindow) : - d_ptr(new WlanWizardPrivate(this, mainWindow)) -{ -} - -/*! - Destructor. - */ -WlanWizard::~WlanWizard() -{ - delete d_ptr; -} - -/*! - Client can set the known WLAN Access Point configurations to speed up wizard - processing and make it easier for end user. - - Values for network mode (CmManagerShim::WlanConnectionMode) and security mode - (CmManagerShim::WlanSecMode). - - Supported configuration sets: - - Open: \a ssid \a networkMode \a securityMode - - WEP: \a ssid \a networkMode \a securityMode - - WPA (2) with EAP: \a ssid \a networkMode \a securityMode \a usePsk (false) - - WPA (2) with PSK: \a ssid \a networkMode \a securityMode \a usePsk (true) - - 802.1x: \a ssid \a networkMode \a securityMode - - Hidden WLAN: - \a hidden can be used with \a networkMode CmManagerShim::Infra - - Wifi Protected Setup - \a wps can be used with Open, WEP and WPA (2) with PSK. - - @param [in] ssid The name of WLAN network (ssid), max length 32 characters. - @param [in] networkMode Network mode of known access point - @param [in] securityMode Security mode of known access point - @param [in] usePsk used only with WPA or WPA2 \a securityMode - @param [in] wps is Wifi Protected Setup supported? - */ -void WlanWizard::setParameters( - const QString &ssid, - int networkMode, - int securityMode, - bool usePsk, - bool wps) -{ - d_ptr->setParameters(ssid, networkMode, securityMode, usePsk, wps); -} - -/*! - Executes the wizard and shows the first page. - - @note it is not allowed to call this method twice with same instance. - - Possible signals: - - finished(int, bool): called after wizard has successfully completed - - cancelled(): user has cancelled the wizard operations. - - First page for the wizard is SSID (WLAN network name) query or if - setParameters() has been called the first page is determined based on the - given configuration combination. - */ -void WlanWizard::show() -{ - d_ptr->show(); -}