diff -r 594d59766373 -r 7d48bed6ce0c cellular/telephonysettings/xqbindings/psetwrapper/src/psetnetworkwrapper.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cellular/telephonysettings/xqbindings/psetwrapper/src/psetnetworkwrapper.cpp Tue Aug 31 15:45:17 2010 +0300 @@ -0,0 +1,232 @@ +/* + * Copyright (c) 2009 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: + * + */ + +#include +#include "psetnetworkwrapper.h" +#include "psetnetworkwrapper_p.h" +#include "logging.h" + +/*! + \class PSetNetworkWrapper + \brief TODO: description +*/ + +/*! + \enum PSetNetworkWrapper::ErrorCode + + This enumeration defines error codes used by PSetNetworkWrapper. +*/ +/*! + \var PSetNetworkWrapper::ErrNoError + Indicates that no error has happened. +*/ + +// TODO: better commenting for NetworkAccessMode enumeration +/*! + \enum NetworkAccessMode + This enumeration defines possible network access modes. +*/ +/*! + \var PSetNetworkWrapper::AccessModeDual + Dual mode. +*/ +/*! + \var PSetNetworkWrapper::AccessModeUmts + 3g/UMTS network mode. +*/ +/*! + \var PSetNetworkWrapper::AccessModeGsm + 2g/GSM network mode. +*/ + +/*! + \struct PSetNetworkWrapper::NetworkId + NetworkId contains network and country identifiers. +*/ +// TODO: is that valid way to document struct members +/*! + \var PSetNetworkWrapper::NetworkId::m_countryCode + Country code. Maximum length is 4. +*/ +/*! + \var PSetNetworkWrapper::NetworkId::m_networkCode + Network code. Maximum length is 8. +*/ + +/*! + \enum PSetNetworkWrapper::NetworkSelectionMode + Network selection mode. +*/ +/*! + \var PSetNetworkWrapper::SelectionModeManual + Specific network is selected manually. +*/ +/*! + \var PSetNetworkWrapper::SelectionModeAutomatic + Network is selected automatically without user interaction. +*/ + +/*! + \enum PSetNetworkWrapper::NetworkStatus + Status of a network. +*/ +// TODO: enumerator comments +/*! + \var PSetNetworkWrapper::StatusUnknown +*/ +/*! + \var PSetNetworkWrapper::StatusAvailable +*/ +/*! + \var PSetNetworkWrapper::StatusCurrent +*/ +/*! + \var PSetNetworkWrapper::StatusForbidden +*/ + +/*! + \enum PSetNetworkWrapper::NetworkAccessType + Network access type. +*/ +// TODO: enumerator comments +/*! + \var PSetNetworkWrapper::AccessTypeGsm +*/ +/*! + \var PSetNetworkWrapper::AccessTypeWcdma +*/ + +/*! + \struct PSetNetworkWrapper::NetworkInfo + Encapsulates information about network. +*/ +// TODO: struct member commenting + +/*! void PSetNetworkWrapper::networkAccessModeGot( + PSetNetworkWrapper::NetworkAccessMode mode) + + This signal is emitted when the current network access mode query has been + completed. +*/ + +/*! + PSetNetworkWrapper::PSetNetworkWrapper + */ +PSetNetworkWrapper::PSetNetworkWrapper( + CPsetContainer &psetContainer, QObject *parent) + : + QObject(parent), + m_privateImpl(new PSetNetworkWrapperPrivate(*this, psetContainer)) +{ + DPRINT << ": IN"; + + DPRINT << ": OUT"; +} + +/*! + PSetNetworkWrapper::~PSetNetworkWrapper + */ +PSetNetworkWrapper::~PSetNetworkWrapper() +{ + DPRINT << ": IN"; + + delete m_privateImpl; + + DPRINT << ": OUT"; +} + +/*! + Puts network retrieve results into array. +*/ +void PSetNetworkWrapper::getAvailableNetworks() +{ + DPRINT; + + m_privateImpl->getAvailableNetworks(); +} + +/*! + Returns current network selection mode. + + \param aMode Network selection mode. + \return Error code. +*/ +PSetNetworkWrapper::ErrorCode PSetNetworkWrapper::getNetworkSelectionMode( + PSetNetworkWrapper::NetworkSelectionMode& mode) const +{ + DPRINT; + + return m_privateImpl->getNetworkSelectionMode(mode); +} + +/*! + Selects network, also for selecting automatic/manual mode. + \param aInfo Network information. +*/ +void PSetNetworkWrapper::selectNetwork( + const PSetNetworkWrapper::NetworkInfo& info) +{ + DPRINT; + + m_privateImpl->selectNetwork(info); +} + +/*! + Cancels ongoing request if any. +*/ +void PSetNetworkWrapper::cancelRequest() +{ + DPRINT; + + m_privateImpl->cancelRequest(); +} + +/*! + Starts to query network access mode. Result is informed with a + networkAccessModeGot() signal. +*/ +void PSetNetworkWrapper::getNetworkAccessMode() const +{ + DPRINT; + + m_privateImpl->getNetworkAccessMode(); +} + +/*! + Sets network access mode. + \param mode Network access mode. + \return ErrorCode. +*/ +void PSetNetworkWrapper::setNetworkAccessMode( + PSetNetworkWrapper::NetworkAccessMode mode) +{ + DPRINT; + + m_privateImpl->setNetworkAccessMode(mode); +} + +/*! + Is manual network selection supported. +*/ +bool PSetNetworkWrapper::isManualNetworkSelectionSupported() const +{ + DPRINT; + + return m_privateImpl->isManualNetworkSelectionSupported(); +} + +// End of File.