--- /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 <QtGlobal>
+#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.